slack-ruby-client 2.1.0 → 2.2.0

data/bin/commands/admin_apps_requests.rb

@@ -20,6 +20,7 @@ module Slack
         g.desc 'List app requests for a team/workspace.'
         g.long_desc %( List app requests for a team/workspace. )
         g.command 'list' do |c|
+          c.flag 'certified', desc: 'Include requests for certified apps.'
           c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
           c.flag 'enterprise_id', desc: '.'
           c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 - 1000 both inclusive.'

data/bin/commands/admin_apps_restricted.rb

@@ -9,6 +9,7 @@ module Slack
         g.desc 'List restricted apps for an org or workspace.'
         g.long_desc %( List restricted apps for an org or workspace. )
         g.command 'list' do |c|
+          c.flag 'certified', desc: 'Limit the results to only include certified apps. When false, no certified apps will appear in the result.'
           c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
           c.flag 'enterprise_id', desc: '.'
           c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 - 1000 both inclusive.'

data/bin/commands/admin_functions.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AdminFunctions methods.'
+      command 'admin_functions' do |g|
+        g.desc 'Look up functions by a set of apps'
+        g.long_desc %( Look up functions by a set of apps )
+        g.command 'list' do |c|
+          c.flag 'app_ids', desc: 'Comma-separated array of app IDs to get functions for; max 50.'
+          c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
+          c.flag 'limit', desc: 'The number of results that will be returned by the API on each invocation. Must be between 1 and 1000, both inclusive.'
+          c.flag 'team_id', desc: 'The team context to retrieve functions from.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_functions_list(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/admin_functions_permissions.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AdminFunctionsPermissions methods.'
+      command 'admin_functions_permissions' do |g|
+        g.desc 'Lookup the visibility of multiple Slack functions and include the users if it is limited to particular named entities.'
+        g.long_desc %( Lookup the visibility of multiple Slack functions and include the users if it is limited to particular named entities. )
+        g.command 'lookup' do |c|
+          c.flag 'function_ids', desc: 'An array of function IDs to get permissions for.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_functions_permissions_lookup(options))
+          end
+        end
+
+        g.desc 'Set the visibility of a Slack function and define the users or workspaces if it is set to named_entities'
+        g.long_desc %( Set the visibility of a Slack function and define the users or workspaces if it is set to named_entities )
+        g.command 'set' do |c|
+          c.flag 'function_id', desc: 'The function ID to set permissions for.'
+          c.flag 'visibility', desc: 'The function visibility.'
+          c.flag 'user_ids', desc: 'List of user IDs to allow for named_entities visibility.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_functions_permissions_set(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/admin_roles.rb

@@ -22,7 +22,7 @@ module Slack
         g.command 'listAssignments' do |c|
           c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
           c.flag 'entity_ids', desc: 'The entities for which the roles apply.'
-          c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 - 100 both inclusive.'
+          c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 - 200 both inclusive.'
           c.flag 'role_ids', desc: 'collection of role ids to scope results by.'
           c.flag 'sort_dir', desc: 'Sort direction. Default is descending on date_create, can be either ASC or DESC.'
           c.action do |_global_options, options, _args|

data/bin/commands/admin_teams.rb

@@ -22,7 +22,7 @@ module Slack
         g.long_desc %( List all teams on an Enterprise organization )
         g.command 'list' do |c|
           c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
-          c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 - 100 both inclusive.'
+          c.flag 'limit', desc: 'The maximum number of items to return. Must be a positive integer no larger than 1000.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_teams_list(options))
           end

data/bin/commands/admin_users.rb

@@ -31,7 +31,7 @@ module Slack
           c.flag 'is_restricted', desc: 'Is this user a multi-channel guest user? (default: false).'
           c.flag 'is_ultra_restricted', desc: 'Is this user a single channel guest user? (default: false).'
           c.flag 'real_name', desc: 'Full name of the user.'
-          c.flag 'resend', desc: 'Allow this invite to be resent in the future if a user has not signed up yet. (default: false).'
+          c.flag 'resend', desc: 'Allow this invite to be resent in the future if a user has not signed up yet. Resending can only be done via the UI and has no expiration. (default: false).'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_users_invite(options))
           end
@@ -71,7 +71,7 @@ module Slack
         g.desc 'Set an expiration for a guest user'
         g.long_desc %( Set an expiration for a guest user )
         g.command 'setExpiration' do |c|
-          c.flag 'expiration_ts', desc: 'Timestamp when guest account should be disabled.'
+          c.flag 'expiration_ts', desc: 'Epoch timestamp in seconds when guest account should be disabled.'
           c.flag 'user_id', desc: 'The ID of the user to set an expiration for.'
           c.flag 'team_id', desc: 'The ID (T1234) of the workspace.'
           c.action do |_global_options, options, _args|

data/bin/commands/admin_workflows.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AdminWorkflows methods.'
+      command 'admin_workflows' do |g|
+        g.desc 'Search workflows within the team or enterprise'
+        g.long_desc %( Search workflows within the team or enterprise )
+        g.command 'search' do |c|
+          c.flag 'app_id', desc: 'The parent app ID for which to return workflows.'
+          c.flag 'collaborator_ids', desc: 'Only include workflows by the collaborators inputted.'
+          c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
+          c.flag 'limit', desc: 'The number of results that will be returned by the API on each invocation.'
+          c.flag 'no_collaborators', desc: 'Only include workflows with no collaborators in the result; default is false.'
+          c.flag 'num_trigger_ids', desc: 'Number of trigger IDs to fetch for each workflow; default is 0.'
+          c.flag 'query', desc: 'A search query to filter for workflow name or description.'
+          c.flag 'sort', desc: 'The field used to sort the returned workflows.'
+          c.flag 'sort_dir', desc: 'Sort direction. Possible values are asc for ascending order like (1, 2, 3) or (a, b, c), and desc for descending order like (3, 2, 1) or (c, b, a).'
+          c.flag 'source', desc: 'Source of workflow creation, either from code or workflow builder.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_workflows_search(options))
+          end
+        end
+
+        g.desc 'Unpublish workflows within the team or enterprise'
+        g.long_desc %( Unpublish workflows within the team or enterprise )
+        g.command 'unpublish' do |c|
+          c.flag 'workflow_ids', desc: 'Array of workflow IDs to unpublish.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_workflows_unpublish(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/admin_workflows_collaborators.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AdminWorkflowsCollaborators methods.'
+      command 'admin_workflows_collaborators' do |g|
+        g.desc 'Add collaborators to workflows within the team or enterprise'
+        g.long_desc %( Add collaborators to workflows within the team or enterprise )
+        g.command 'add' do |c|
+          c.flag 'collaborator_ids', desc: 'Array of collaborators (encoded user IDs) to add; max 50.'
+          c.flag 'workflow_ids', desc: 'Array of workflow IDs to edit; max 50.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_workflows_collaborators_add(options))
+          end
+        end
+
+        g.desc 'Remove collaborators from workflows within the team or enterprise'
+        g.long_desc %( Remove collaborators from workflows within the team or enterprise )
+        g.command 'remove' do |c|
+          c.flag 'collaborator_ids', desc: 'Array of collaborators (encoded user IDs) to remove; max 50.'
+          c.flag 'workflow_ids', desc: 'Array of workflow IDs to edit; max 50.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_workflows_collaborators_remove(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/admin_workflows_permissions.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AdminWorkflowsPermissions methods.'
+      command 'admin_workflows_permissions' do |g|
+        g.desc 'Look up the permissions for a set of workflows'
+        g.long_desc %( Look up the permissions for a set of workflows )
+        g.command 'lookup' do |c|
+          c.flag 'workflow_ids', desc: 'An array of workflow IDs to look up permissions for.'
+          c.flag 'max_workflow_triggers', desc: 'Maximum number of triggers to fetch for each workflow when determining overall run permissions; max 1000.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_workflows_permissions_lookup(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/apps_activities.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AppsActivities methods.'
+      command 'apps_activities' do |g|
+        g.desc 'Get logs for a specified app'
+        g.long_desc %( Get logs for a specified app )
+        g.command 'list' do |c|
+          c.flag 'app_id', desc: 'The id of the app to get activities from.'
+          c.flag 'component_id', desc: "The component id of log events to be returned. Will be 'FnXXXXXX' for functions, and 'WfXXXXXX' for worflows."
+          c.flag 'component_type', desc: "The component type of log events to be returned. Acceptable values are ('events_api', 'workflows', 'functions', 'tables')."
+          c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. See pagination for more detail."
+          c.flag 'limit', desc: 'The maximum number of items to return.'
+          c.flag 'log_event_type', desc: 'The event type of log events to be returned.'
+          c.flag 'max_date_created', desc: 'The latest timestamp of the log to retrieve (epoch microseconds).'
+          c.flag 'min_date_created', desc: 'The earliest timestamp of the log to retrieve (epoch microseconds).'
+          c.flag 'min_log_level', desc: "The minimum log level of the log events to be returned. Defaults to 'info'. Acceptable values (in order of relative importance from smallest to largest) are ('trace', 'debug', 'info', 'warn', 'error', 'fatal')."
+          c.flag 'sort_direction', desc: 'The direction you want the data sorted by (always by timestamp).'
+          c.flag 'source', desc: "The source of log events to be returned. Acceptable values are ('slack', 'developer')."
+          c.flag 'team_id', desc: 'The team who owns this log.'
+          c.flag 'trace_id', desc: 'The trace id of log events to be returned.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.apps_activities_list(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/apps_auth_external.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AppsAuthExternal methods.'
+      command 'apps_auth_external' do |g|
+        g.desc 'Delete external auth tokens only on the Slack side'
+        g.long_desc %( Delete external auth tokens only on the Slack side )
+        g.command 'delete' do |c|
+          c.flag 'app_id', desc: 'The id of the app whose tokens you want to delete.'
+          c.flag 'external_token_id', desc: 'The id of the token that you want to delete.'
+          c.flag 'provider_key', desc: 'The provider key of the provider whose tokens you want to delete.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.apps_auth_external_delete(options))
+          end
+        end
+
+        g.desc 'Get the access token for the provided token ID'
+        g.long_desc %( Get the access token for the provided token ID )
+        g.command 'get' do |c|
+          c.flag 'external_token_id', desc: 'The id of the token you want to get the token for.'
+          c.flag 'force_refresh', desc: 'Always refresh existing token before returning even when the token has not expired.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.apps_auth_external_get(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/apps_datastore.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AppsDatastore methods.'
+      command 'apps_datastore' do |g|
+        g.desc 'Delete an item from a datastore'
+        g.long_desc %( Delete an item from a datastore )
+        g.command 'delete' do |c|
+          c.flag 'datastore', desc: 'name of the datastore.'
+          c.flag 'id', desc: 'item id.'
+          c.flag 'app_id', desc: '.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.apps_datastore_delete(options))
+          end
+        end
+
+        g.desc 'Get an item from a datastore'
+        g.long_desc %( Get an item from a datastore )
+        g.command 'get' do |c|
+          c.flag 'datastore', desc: 'name of the datastore.'
+          c.flag 'id', desc: 'item id.'
+          c.flag 'app_id', desc: '.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.apps_datastore_get(options))
+          end
+        end
+
+        g.desc 'Creates a new item, or replaces an old item with a new item.'
+        g.long_desc %( Creates a new item, or replaces an old item with a new item. )
+        g.command 'put' do |c|
+          c.flag 'datastore', desc: 'name of the datastore.'
+          c.flag 'item', desc: 'attribute names and values of the item.'
+          c.flag 'app_id', desc: '.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.apps_datastore_put(options))
+          end
+        end
+
+        g.desc 'Query a datastore for items'
+        g.long_desc %( Query a datastore for items )
+        g.command 'query' do |c|
+          c.flag 'datastore', desc: 'Name of the datastore.'
+          c.flag 'app_id', desc: 'Required if calling with user token.'
+          c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
+          c.flag 'expression', desc: 'A query filter expression https://api.slack.com/future/datastores.'
+          c.flag 'expression_attributes', desc: 'A map of attributes referenced in expression.'
+          c.flag 'expression_values', desc: 'A map of values referenced in expression.'
+          c.flag 'limit', desc: 'The maximum number of items to evaluate for a given request (not necessarily the number of matching items). If the given request dataset size exceeds 1 MB before reaching the limit, the returned item count will likely be less than the limit. In any case where there are more items available beyond an imposed limit, a next_cursor value will be provided for use in subsequent requests.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.apps_datastore_query(options))
+          end
+        end
+
+        g.desc "Edits an existing item's attributes, or adds a new item if it does not already exist."
+        g.long_desc %( Edits an existing item's attributes, or adds a new item if it does not already exist. )
+        g.command 'update' do |c|
+          c.flag 'datastore', desc: 'name of the datastore.'
+          c.flag 'item', desc: 'attribute names and values to be updated.'
+          c.flag 'app_id', desc: '.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.apps_datastore_update(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/auth_teams.rb

@@ -6,8 +6,8 @@ module Slack
     class App
       desc 'AuthTeams methods.'
       command 'auth_teams' do |g|
-        g.desc 'List the workspaces a token can access.'
-        g.long_desc %( List the workspaces a token can access. )
+        g.desc 'Obtain a full list of workspaces your org-wide app has been approved for.'
+        g.long_desc %( Obtain a full list of workspaces your org-wide app has been approved for. )
         g.command 'list' do |c|
           c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
           c.flag 'include_icon', desc: 'Whether to return icon paths for each workspace. An icon path represents a URI pointing to the image signifying the workspace.'

data/bin/commands/calls.rb

@@ -12,7 +12,7 @@ module Slack
           c.flag 'external_unique_id', desc: 'An ID supplied by the 3rd-party Call provider. It must be unique across all Calls from that service.'
           c.flag 'join_url', desc: 'The URL required for a client to join the Call.'
           c.flag 'created_by', desc: 'The valid Slack user ID of the user who created this Call. When this method is called with a user token, the created_by field is optional and defaults to the authed user of the token. Otherwise, the field is required.'
-          c.flag 'date_start', desc: 'Call start time in UTC UNIX timestamp format.'
+          c.flag 'date_start', desc: 'Unix timestamp of the call start time.'
           c.flag 'desktop_app_join_url', desc: 'When supplied, available Slack clients will attempt to directly launch the 3rd-party Call with this URL.'
           c.flag 'external_display_id', desc: 'An optional, human-readable ID supplied by the 3rd-party Call provider. If supplied, this ID will be displayed in the Call object.'
           c.flag 'title', desc: 'The name of the Call.'

data/bin/commands/chat.rb

@@ -68,12 +68,12 @@ module Slack
           c.flag 'as_user', desc: '(Legacy) Pass true to post the message as the authed user. Defaults to true if the chat:write:bot scope is not included. Otherwise, defaults to false.'
           c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
           c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
-          c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.'
-          c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.'
+          c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url.'
+          c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message.'
           c.flag 'link_names', desc: 'Find and link channel names and usernames.'
           c.flag 'parse', desc: 'Change how messages are treated. Defaults to none. See below.'
           c.flag 'thread_ts', desc: "Provide another message's ts value to post this message in a thread. Avoid using a reply's ts value; use its parent's value instead. Ephemeral messages in threads are only shown if there is already an active thread."
-          c.flag 'username', desc: "Set your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below."
+          c.flag 'username', desc: "Set your bot's user name."
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.chat_postEphemeral(options))
           end
@@ -87,8 +87,8 @@ module Slack
           c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
           c.flag 'text', desc: 'The formatted text of the message to be published. If blocks are included, this will become the fallback text used in notifications.'
           c.flag 'as_user', desc: '(Legacy) Pass true to post the message as the authed user instead of as a bot. Defaults to false. Can only be used by classic Slack apps. See authorship below.'
-          c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.'
-          c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.'
+          c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url.'
+          c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message.'
           c.flag 'link_names', desc: 'Find and link user groups. No longer supports linking individual users; use syntax shown in Mentioning Users instead.'
           c.flag 'metadata', desc: 'JSON object with event_type and event_payload fields, presented as a URL-encoded string. Metadata you post to Slack is accessible to any app or user who is a member of that workspace.'
           c.flag 'mrkdwn', desc: 'Disable Slack markup parsing by setting to false. Enabled by default.'
@@ -97,7 +97,7 @@ module Slack
           c.flag 'thread_ts', desc: "Provide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead."
           c.flag 'unfurl_links', desc: 'Pass true to enable unfurling of primarily text-based content.'
           c.flag 'unfurl_media', desc: 'Pass false to disable unfurling of media content.'
-          c.flag 'username', desc: "Set your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below."
+          c.flag 'username', desc: "Set your bot's user name."
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.chat_postMessage(options))
           end

data/bin/commands/chat_scheduledMessages.rb

@@ -11,9 +11,9 @@ module Slack
         g.command 'list' do |c|
           c.flag 'channel', desc: 'The channel of the scheduled messages.'
           c.flag 'cursor', desc: 'For pagination purposes, this is the cursor value returned from a previous call to chat.scheduledmessages.list indicating where you want to start this call from.'
-          c.flag 'latest', desc: 'A UNIX timestamp of the latest value in the time range.'
+          c.flag 'latest', desc: 'A Unix timestamp of the latest value in the time range.'
           c.flag 'limit', desc: 'Maximum number of original entries to return.'
-          c.flag 'oldest', desc: 'A UNIX timestamp of the oldest value in the time range.'
+          c.flag 'oldest', desc: 'A Unix timestamp of the oldest value in the time range.'
           c.flag 'team_id', desc: 'encoded team id to list channels in, required if org token is used.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.chat_scheduledMessages_list(options))

data/bin/commands/conversations.rb

@@ -12,7 +12,7 @@ module Slack
           c.flag 'channel_name', desc: 'Name of the channel. If the channel does not exist already in your workspace, this name is the one that the channel will take.'
           c.flag 'channel_id', desc: "ID of the channel that you'd like to accept. Must provide either invite_id or channel_id."
           c.flag 'free_trial_accepted', desc: "Whether you'd like to use your workspace's free trial to begin using Slack Connect."
-          c.flag 'invite_id', desc: 'See the shared_channel_invite_received event payload for more details on how to retrieve the ID of the invitation.'
+          c.flag 'invite_id', desc: "ID of the invite that you'd like to accept. Must provide either invite_id or channel_id. See the shared_channel_invite_received event payload for more details on how to retrieve the ID of the invitation."
           c.flag 'is_private', desc: 'Whether the channel should be private.'
           c.flag 'team_id', desc: 'The ID of the workspace to accept the channel in. If an org-level token is used to call this method, the team_id argument is required.'
           c.action do |_global_options, options, _args|
@@ -109,9 +109,9 @@ module Slack
         g.long_desc %( Sends an invitation to a Slack Connect channel )
         g.command 'inviteShared' do |c|
           c.flag 'channel', desc: "ID of the channel on your team that you'd like to share."
-          c.flag 'emails', desc: 'Optional email to receive this invite. Either emails or user_ids must be provided.'
+          c.flag 'emails', desc: 'Optional email to receive this invite. Either emails or user_ids must be provided. Only one email or one user ID may be invited at a time.'
           c.flag 'external_limited', desc: 'Optional boolean on whether invite is to a external limited member. Defaults to true.'
-          c.flag 'user_ids', desc: 'Optional user_id to receive this invite. Either emails or user_ids must be provided.'
+          c.flag 'user_ids', desc: 'Optional user_id to receive this invite. Either emails or user_ids must be provided. Only one email or one user ID may be invited at a time.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_inviteShared(options))
           end

data/bin/commands/dnd.rb

@@ -35,7 +35,7 @@ module Slack
         g.desc 'Turns on Do Not Disturb mode for the current user, or changes its duration.'
         g.long_desc %( Turns on Do Not Disturb mode for the current user, or changes its duration. )
         g.command 'setSnooze' do |c|
-          c.flag 'num_minutes', desc: 'Number of minutes, from now, to snooze until.'
+          c.flag 'num_minutes', desc: 'This argument is required. Number of minutes, from now, to snooze until.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.dnd_setSnooze(options))
           end

data/bin/commands/functions_workflows_steps.rb

@@ -9,8 +9,9 @@ module Slack
         g.desc "List the steps of a specific function of a workflow's versions"
         g.long_desc %( List the steps of a specific function of a workflow's versions )
         g.command 'list' do |c|
-          c.flag 'function_id', desc: '.'
+          c.flag 'function_id', desc: 'The ID of the function to query.'
           c.flag 'workflow', desc: 'The workflow encoded ID or workflow reference.'
+          c.flag 'workflow_app_id', desc: 'The app tied to the workflow reference.'
           c.flag 'workflow_id', desc: 'The workflow ID, starts with Wf*.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.functions_workflows_steps_list(options))

data/bin/commands/functions_workflows_steps_responses.rb

@@ -9,8 +9,9 @@ module Slack
         g.desc 'Download form responses of a workflow'
         g.long_desc %( Download form responses of a workflow )
         g.command 'export' do |c|
-          c.flag 'step_id', desc: '.'
+          c.flag 'step_id', desc: 'The ID of the OpenForm step to export.'
           c.flag 'workflow', desc: 'The workflow encoded ID or workflow reference.'
+          c.flag 'workflow_app_id', desc: 'The app tied to the workflow reference.'
           c.flag 'workflow_id', desc: 'The workflow ID, starts with Wf*.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.functions_workflows_steps_responses_export(options))

data/bin/commands/reminders.rb

@@ -13,7 +13,7 @@ module Slack
           c.flag 'time', desc: 'When this reminder should happen: the Unix timestamp (up to five years from now), the number of seconds until the reminder (if within 24 hours), or a natural language description (Ex. "in 15 minutes," or "every Thursday").'
           c.flag 'recurrence', desc: 'Specify the repeating behavior of a reminder. Available options: daily, weekly, monthly, or yearly. If weekly, may further specify the days of the week.'
           c.flag 'team_id', desc: 'Encoded team id, required if org token is used.'
-          c.flag 'user', desc: 'The user who will receive the reminder. If no user is specified, the reminder will go to user who created it.'
+          c.flag 'user', desc: 'No longer supported - reminders cannot be set for other users. Previously, was the user who would receive the reminder.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.reminders_add(options))
           end

data/bin/commands/stars.rb

@@ -6,8 +6,8 @@ module Slack
     class App
       desc 'Stars methods.'
       command 'stars' do |g|
-        g.desc 'Save an item for later. Formerly known as _adding a star_.'
-        g.long_desc %( Save an item for later. Formerly known as _adding a star_. )
+        g.desc 'Save an item for later. Formerly known as adding a star.'
+        g.long_desc %( Save an item for later. Formerly known as adding a star. )
         g.command 'add' do |c|
           c.flag 'channel', desc: 'Channel to add star to, or channel where the message to add star to was posted (used with timestamp).'
           c.flag 'file', desc: 'File to add star to.'
@@ -18,8 +18,8 @@ module Slack
           end
         end
 
-        g.desc "List a user's saved items, formerly known as _stars_."
-        g.long_desc %( List a user's saved items, formerly known as _stars_. )
+        g.desc "Listed a user's saved items, formerly known as stars."
+        g.long_desc %( Listed a user's saved items, formerly known as stars. )
         g.command 'list' do |c|
           c.flag 'cursor', desc: "Parameter for pagination. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first 'page' of the collection. See pagination for more details."
           c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached."

data/bin/commands/team.rb

@@ -10,6 +10,8 @@ module Slack
         g.long_desc %( Gets the access logs for the current team. )
         g.command 'accessLogs' do |c|
           c.flag 'before', desc: 'End of time range of logs to include in results (inclusive).'
+          c.flag 'cursor', desc: "Parameter for pagination. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first 'page' of the collection. See pagination for more details."
+          c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached. If specified, result is returned using a cursor-based approach instead of a classic one."
           c.flag 'team_id', desc: 'encoded team id to get logs from, required if org token is used.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.team_accessLogs(options))
@@ -32,7 +34,7 @@ module Slack
         g.long_desc %( Gets information about the current team. )
         g.command 'info' do |c|
           c.flag 'domain', desc: 'Query by domain instead of team (only when team is null). This only works for domains in the same enterprise as the querying team token. This also expects the domain to belong to a team and not the enterprise itself.'
-          c.flag 'team', desc: 'Team to get info on, if omitted, will return information about the current team. Will only return team that the authenticated token is allowed to see through external shared channels.'
+          c.flag 'team', desc: 'Team to get info about; if omitted, will return information about the current team.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.team_info(options))
           end

data/bin/commands/users.rb

@@ -11,7 +11,7 @@ module Slack
         g.command 'conversations' do |c|
           c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail."
           c.flag 'exclude_archived', desc: 'Set to true to exclude archived channels from the list.'
-          c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached. Must be an integer no larger than 1000."
+          c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached. Must be an integer with a max value of 999."
           c.flag 'team_id', desc: 'encoded team id to list conversations in, required if org token is used.'
           c.flag 'types', desc: 'Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im.'
           c.flag 'user', desc: "Browse conversations by a specific user ID's membership. Non-public channels are restricted to those where the calling user shares membership."

data/lib/slack/messages/formatting.rb

@@ -24,6 +24,50 @@ module Slack
               end
             end)
         end
+
+        #
+        # Escape a message.
+        # @see https://api.slack.com/reference/surfaces/formatting#escaping
+        #
+        def escape(message)
+          message
+            .gsub('&', '&')
+            .gsub('>', '>')
+            .gsub('<', '&lt;')
+        end
+
+        #
+        # Format a DateTime or Time object as a date and time in a Slack message
+        # @see https://api.slack.com/reference/surfaces/formatting#date-formatting
+        #
+        def date(time, format: '{date_num} {time_secs}', link: nil, text: nil)
+          args = [time.to_i, format, link].compact
+          "<!date^#{args.join('^')}|#{text || time}>"
+        end
+
+        #
+        # Embed a link to a Slack channel in a message by channel ID
+        # @see https://api.slack.com/reference/surfaces/formatting#linking-channels
+        #
+        def channel_link(channel_id)
+          "<##{channel_id}>"
+        end
+
+        #
+        # Embed a link to a user in a message by user ID
+        # @see https://api.slack.com/reference/surfaces/formatting#mentioning-users
+        #
+        def user_link(user_id)
+          "<@#{user_id}>"
+        end
+
+        #
+        # Embed a URL with custom link text in a message
+        # @see https://api.slack.com/reference/surfaces/formatting#linking-urls
+        #
+        def url_link(text, url)
+          "<#{url}|#{text}>"
+        end
       end
     end
   end

data/lib/slack/real_time/client.rb

@@ -234,14 +234,26 @@ module Slack
 
       def run_handlers(type, data)
         handlers = store.class.events[type.to_s]
-        handlers.each do |handler|
-          store.instance_exec(data, self, &handler)
+        case async_handlers
+        when :all
+          @socket.run_async { handlers_loop(handlers, data) }
+        when :none
+          handlers_loop(handlers, data)
+        else
+          raise Config::InvalidAsyncHandlersError,
+                "Invalid value '#{async_handlers.inspect}' for config#async_handlers, must be :all or :none."
         end
       rescue StandardError => e
         logger.error("#{self}##{__method__}") { e }
         false
       end
 
+      def handlers_loop(handlers, data)
+        handlers.each do |handler|
+          store.instance_exec(data, self, &handler)
+        end
+      end
+
       def run_callbacks(type, data)
         callbacks = self.callbacks[type]
         return false unless callbacks