slack-ruby-client 2.6.0 → 3.0.0

data/bin/commands/apps_auth_external.rb

@@ -10,8 +10,8 @@ module Slack
         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.flag 'external_token_id', desc: 'The id of the token that you want to delete.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.apps_auth_external_delete(options))
           end

data/bin/commands/apps_datastore.rb

@@ -11,7 +11,7 @@ module Slack
         g.command 'bulkDelete' do |c|
           c.flag 'datastore', desc: 'name of the datastore.'
           c.flag 'ids', desc: 'IDs of items to be deleted.'
-          c.flag 'app_id', desc: '.'
+          c.flag 'app_id', desc: ''
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.apps_datastore_bulkDelete(options))
           end
@@ -22,7 +22,7 @@ module Slack
         g.command 'bulkGet' do |c|
           c.flag 'datastore', desc: 'name of the datastore.'
           c.flag 'ids', desc: "items' ids."
-          c.flag 'app_id', desc: '.'
+          c.flag 'app_id', desc: ''
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.apps_datastore_bulkGet(options))
           end
@@ -33,7 +33,7 @@ module Slack
         g.command 'bulkPut' do |c|
           c.flag 'datastore', desc: 'name of the datastore.'
           c.flag 'items', desc: 'attribute names and values of the items; limit of 25.'
-          c.flag 'app_id', desc: '.'
+          c.flag 'app_id', desc: ''
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.apps_datastore_bulkPut(options))
           end
@@ -43,10 +43,10 @@ module Slack
         g.long_desc %( Count the number of items in a datastore that match a query )
         g.command 'count' do |c|
           c.flag 'datastore', desc: 'Name of the datastore.'
-          c.flag 'app_id', desc: 'Required if calling with user token.'
-          c.flag 'expression', desc: 'A query filter expression https://api.slack.com/future/datastores.'
+          c.flag 'expression', desc: 'A query filter expression.'
           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 'app_id', desc: 'Required if calling with user token.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.apps_datastore_count(options))
           end
@@ -57,7 +57,7 @@ module Slack
         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.flag 'app_id', desc: ''
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.apps_datastore_delete(options))
           end
@@ -68,7 +68,7 @@ module Slack
         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.flag 'app_id', desc: ''
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.apps_datastore_get(options))
           end
@@ -79,7 +79,7 @@ module Slack
         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.flag 'app_id', desc: ''
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.apps_datastore_put(options))
           end
@@ -89,11 +89,11 @@ module Slack
         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', desc: 'A query filter expression.'
           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 '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 '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))
@@ -105,7 +105,7 @@ module Slack
         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.flag 'app_id', desc: ''
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.apps_datastore_update(options))
           end

data/bin/commands/apps_event_authorizations.rb

@@ -9,9 +9,9 @@ module Slack
         g.desc 'Get a list of authorizations for the given event context. Each authorization represents an app installation that the event is visible to.'
         g.long_desc %( Get a list of authorizations for the given event context. Each authorization represents an app installation that the event is visible to. )
         g.command 'list' do |c|
-          c.flag 'event_context', desc: '.'
-          c.flag 'cursor', desc: '.'
-          c.flag 'limit', desc: '.'
+          c.flag 'event_context', desc: ''
+          c.flag 'cursor', desc: ''
+          c.flag 'limit', desc: ''
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.apps_event_authorizations_list(options))
           end

data/bin/commands/apps_manifest.rb

@@ -36,8 +36,8 @@ module Slack
         g.desc 'Update an app from an app manifest'
         g.long_desc %( Update an app from an app manifest )
         g.command 'update' do |c|
+          c.flag 'manifest', desc: 'A JSON app manifest encoded as a string. This manifest must use a valid app manifest schema - read our guide to creating one. As this method entirely _replaces_ any previous configuration, manifest must contain both unmodified and modified fields.'
           c.flag 'app_id', desc: 'The ID of the app whose configuration you want to update.'
-          c.flag 'manifest', desc: 'A JSON app manifest encoded as a string. This manifest must use a valid app manifest schema - read our guide to creating one. As this method entirely replaces any previous configuration, manifest must contain both unmodified and modified fields.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.apps_manifest_update(options))
           end

data/bin/commands/assistant_search.rb

@@ -12,15 +12,31 @@ module Slack
           c.flag 'query', desc: 'User prompt or search query.'
           c.flag 'action_token', desc: 'Send action_token as received in a message event.'
           c.flag 'channel_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 'content_types', desc: 'Content types to include, a comma-separated list of any combination of messages, files.'
+          c.flag 'content_types', desc: 'Content types to include, a comma-separated list of any combination of messages, files, channels, users.'
+          c.flag 'include_bots', desc: 'If you want the results to include bots.'
+          c.flag 'before', desc: 'UNIX timestamp filter. If present, filters for results before this date.'
+          c.flag 'after', desc: 'UNIX timestamp filter. If present, filters for results after this date.'
+          c.flag 'include_context_messages', desc: 'Whether to include context messages surrounding the main message result. Defaults to false if unspecified.'
           c.flag 'context_channel_id', desc: 'Context channel ID to support scoping the search when applicable.'
           c.flag 'cursor', desc: 'The cursor returned by the API. Leave this blank for the first request, and use this to get the next page of results.'
-          c.flag 'include_bots', desc: 'If you want the results to include bots.'
           c.flag 'limit', desc: 'Number of results to return, up to a max of 20. Defaults to 20.'
+          c.flag 'sort', desc: 'The field to sort the results by. Defaults to score. Can be one of: score, timestamp.'
+          c.flag 'sort_dir', desc: 'The direction to sort the results by. Defaults to desc.'
+          c.flag 'include_message_blocks', desc: 'Whether to return the message blocks in the response.'
+          c.flag 'highlight', desc: 'Whether to highlight the search query in the results. Defaults to false if unspecified.'
+          c.flag 'term_clauses', desc: 'A list of term clauses. A term clause is a string with search terms. Search results returned will match every term clause specified (i.e. conjunctive normal form).'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.assistant_search_context(options))
           end
         end
+
+        g.desc 'Returns search capabilities on a given team.'
+        g.long_desc %( Returns search capabilities on a given team. )
+        g.command 'info' do |c|
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.assistant_search_info(options))
+          end
+        end
       end
     end
   end

data/bin/commands/assistant_threads.rb

@@ -10,8 +10,8 @@ module Slack
         g.long_desc %( Set the status for an AI assistant thread. )
         g.command 'setStatus' do |c|
           c.flag 'channel_id', desc: 'Channel ID containing the assistant thread.'
-          c.flag 'status', desc: "Status of the specified bot user, e.g. 'is thinking...'."
           c.flag 'thread_ts', desc: 'Message timestamp of the thread of where to set the status.'
+          c.flag 'status', desc: "Status of the specified bot user, e.g. 'is thinking...'."
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.assistant_threads_setStatus(options))
           end
@@ -21,8 +21,8 @@ module Slack
         g.long_desc %( Set suggested prompts for the given assistant thread )
         g.command 'setSuggestedPrompts' do |c|
           c.flag 'channel_id', desc: 'Channel ID containing the assistant thread.'
-          c.flag 'prompts', desc: 'Each prompt should be supplied with its title and message attribute.'
           c.flag 'thread_ts', desc: 'Message timestamp of the thread to set suggested prompts for.'
+          c.flag 'prompts', desc: 'Each prompt should be supplied with its title and message attribute.'
           c.flag 'title', desc: 'Title for the list of provided prompts. For example: Suggested Prompts, Related Questions.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.assistant_threads_setSuggestedPrompts(options))

data/bin/commands/auth.rb

@@ -9,7 +9,7 @@ module Slack
         g.desc 'Revokes a token.'
         g.long_desc %( Revokes a token. )
         g.command 'revoke' do |c|
-          c.flag 'test', desc: 'Setting this parameter to 1 triggers a testing mode where the specified token will not actually be revoked.'
+          c.flag 'test', desc: 'Setting this parameter to 1 triggers a _testing mode_ where the specified token will not actually be revoked.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.auth_revoke(options))
           end

data/bin/commands/auth_teams.rb

@@ -9,9 +9,9 @@ module Slack
         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 'limit', desc: 'The maximum number of workspaces to return. Must be a positive integer no larger than 1000.'
           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.'
-          c.flag 'limit', desc: 'The maximum number of workspaces to return. Must be a positive integer no larger than 1000.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.auth_teams_list(options))
           end

data/bin/commands/bookmarks.rb

@@ -11,11 +11,11 @@ module Slack
         g.command 'add' do |c|
           c.flag 'channel_id', desc: 'Channel to add bookmark in.'
           c.flag 'title', desc: 'Title for the bookmark.'
+          c.flag 'link', desc: 'Link to bookmark.'
           c.flag 'type', desc: 'Type of the bookmark i.e link.'
-          c.flag 'access_level', desc: "The level that we are setting the file's permission to (read or write)."
           c.flag 'emoji', desc: 'Emoji tag to apply to the link.'
           c.flag 'entity_id', desc: 'ID of the entity being bookmarked. Only applies to message and file types.'
-          c.flag 'link', desc: 'Link to bookmark.'
+          c.flag 'access_level', desc: "The level that we are setting the file's permission to (read or write)."
           c.flag 'parent_id', desc: "Id of this bookmark's parent."
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.bookmarks_add(options))
@@ -25,11 +25,11 @@ module Slack
         g.desc 'Edit bookmark.'
         g.long_desc %( Edit bookmark. )
         g.command 'edit' do |c|
-          c.flag 'bookmark_id', desc: 'Bookmark to update.'
           c.flag 'channel_id', desc: 'Channel to update bookmark in.'
-          c.flag 'emoji', desc: 'Emoji tag to apply to the link.'
-          c.flag 'link', desc: 'Link to bookmark.'
+          c.flag 'bookmark_id', desc: 'Bookmark to update.'
           c.flag 'title', desc: 'Title for the bookmark.'
+          c.flag 'link', desc: 'Link to bookmark.'
+          c.flag 'emoji', desc: 'Emoji tag to apply to the link.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.bookmarks_edit(options))
           end
@@ -47,8 +47,8 @@ module Slack
         g.desc 'Remove bookmark from the channel.'
         g.long_desc %( Remove bookmark from the channel. )
         g.command 'remove' do |c|
-          c.flag 'bookmark_id', desc: 'Bookmark to remove.'
           c.flag 'channel_id', desc: 'Channel to remove bookmark.'
+          c.flag 'bookmark_id', desc: 'Bookmark to remove.'
           c.flag 'quip_section_id', desc: 'Quip section ID to unbookmark.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.bookmarks_remove(options))

data/bin/commands/calls.rb

@@ -10,12 +10,12 @@ module Slack
         g.long_desc %( Registers a new Call. )
         g.command 'add' do |c|
           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 '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 '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: '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 'date_start', desc: 'Unix timestamp of the call start time.'
           c.flag 'title', desc: 'The name of 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 'users', desc: 'The list of users to register as participants in the Call. Read more on how to specify users here.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.calls_add(options))
@@ -45,9 +45,9 @@ module Slack
         g.long_desc %( Updates information about a Call. )
         g.command 'update' do |c|
           c.flag 'id', desc: 'id returned by the calls.add method.'
-          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 'join_url', desc: 'The URL required for a client to join the Call.'
           c.flag 'title', desc: 'The name of the Call.'
+          c.flag 'join_url', desc: 'The URL required for a client to join the Call.'
+          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.action do |_global_options, options, _args|
             puts JSON.dump(@client.calls_update(options))
           end

data/bin/commands/canvases.rb

@@ -9,9 +9,9 @@ module Slack
         g.desc 'Create canvas for a user'
         g.long_desc %( Create canvas for a user )
         g.command 'create' do |c|
-          c.flag 'channel_id', desc: 'Channel ID of the channel the canvas will be tabbed in. This is a required field for free teams.'
-          c.flag 'document_content', desc: 'Structure describing the type and value of the content to create.'
           c.flag 'title', desc: 'Title of the newly created canvas.'
+          c.flag 'document_content', desc: 'Structure describing the type and value of the content to create.'
+          c.flag 'channel_id', desc: 'Channel ID of the channel the canvas will be tabbed in. This is a required field for free teams.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.canvases_create(options))
           end

data/bin/commands/canvases_access.rb

@@ -20,8 +20,8 @@ module Slack
         g.desc 'Sets the access level to a canvas for specified entities'
         g.long_desc %( Sets the access level to a canvas for specified entities )
         g.command 'set' do |c|
-          c.flag 'access_level', desc: 'Desired level of access.'
           c.flag 'canvas_id', desc: 'Encoded ID of the canvas.'
+          c.flag 'access_level', desc: 'Desired level of access.'
           c.flag 'channel_ids', desc: 'List of channels you wish to update access for. Can only be used if user_ids is not provided.'
           c.flag 'user_ids', desc: 'List of users you wish to update access for. Can only be used if channel_ids is not provided.'
           c.action do |_global_options, options, _args|

data/bin/commands/chat.rb

@@ -20,9 +20,9 @@ module Slack
         g.desc 'Deletes a message.'
         g.long_desc %( Deletes a message. )
         g.command 'delete' do |c|
+          c.flag 'as_user', desc: '(Legacy) Pass true to delete the message as the authed user with chat:write:user scope. Bot users in this context are considered authed users. See legacy as_user parameter below.'
           c.flag 'channel', desc: 'Channel containing the message to be deleted.'
           c.flag 'ts', desc: 'Timestamp of the message to be deleted.'
-          c.flag 'as_user', desc: 'Pass true to delete the message as the authed user with chat:write:user scope. Bot users in this context are considered authed users. If unused or false, the message will be deleted with chat:write:bot scope.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.chat_delete(options))
           end
@@ -31,9 +31,9 @@ module Slack
         g.desc 'Deletes a pending scheduled message from the queue.'
         g.long_desc %( Deletes a pending scheduled message from the queue. )
         g.command 'deleteScheduledMessage' do |c|
+          c.flag 'as_user', desc: 'Pass true to delete the message as the authed user with chat:write:user scope. Bot users in this context are considered authed users. If unused or false, the message will be deleted with chat:write:bot scope.'
           c.flag 'channel', desc: 'The channel the scheduled_message is posting to.'
           c.flag 'scheduled_message_id', desc: 'scheduled_message_id returned from call to chat.scheduleMessage.'
-          c.flag 'as_user', desc: 'Pass true to delete the message as the authed user with chat:write:user scope. Bot users in this context are considered authed users. If unused or false, the message will be deleted with chat:write:bot scope.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.chat_deleteScheduledMessage(options))
           end
@@ -62,18 +62,18 @@ module Slack
         g.desc 'Sends an ephemeral message to a user in a channel.'
         g.long_desc %( Sends an ephemeral message to a user in a channel. )
         g.command 'postEphemeral' do |c|
-          c.flag 'channel', desc: 'Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name.'
-          c.flag 'user', desc: 'id of the user who will receive the ephemeral message. The user should be in the channel specified by the channel argument.'
+          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 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
-          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 'channel', desc: 'Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name.'
           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 'markdown_text', desc: 'Accepts message text formatted in markdown. This argument should not be used in conjunction with blocks or text. Limit this field to 12,000 characters.'
           c.flag 'parse', desc: 'Change how messages are treated. Defaults to none. See below.'
+          c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
           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 'user', desc: 'id of the user who will receive the ephemeral message. The user should be in the channel specified by the channel argument.'
           c.flag 'username', desc: "Set your bot's user name."
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.chat_postEphemeral(options))
@@ -83,12 +83,10 @@ module Slack
         g.desc 'Sends a message to a channel.'
         g.long_desc %( Sends a message to a channel. )
         g.command 'postMessage' do |c|
-          c.flag 'channel', desc: 'An encoded ID or channel name that represents a channel, private group, or IM channel to send the message to. See below for more details.'
+          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 apps. See legacy as_user parameter below.'
           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 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
-          c.flag 'agent_message_source_type', desc: 'Identify how the message was posted for agentforce BE logging.'
-          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 apps. See legacy as_user parameter below.'
+          c.flag 'channel', desc: 'An encoded ID or channel name that represents a channel, private group, or IM channel to send the message to. See below for more details.'
           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.'
@@ -97,6 +95,7 @@ module Slack
           c.flag 'mrkdwn', desc: 'Disable Slack markup parsing by setting to false. Enabled by default.'
           c.flag 'parse', desc: 'Change how messages are treated. See below.'
           c.flag 'reply_broadcast', desc: 'Used in conjunction with thread_ts and indicates whether reply should be made visible to everyone in the channel or conversation. Defaults to false.'
+          c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
           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.'
@@ -109,20 +108,20 @@ module Slack
         g.desc 'Schedules a message to be sent to a channel.'
         g.long_desc %( Schedules a message to be sent to a channel. )
         g.command 'scheduleMessage' do |c|
-          c.flag 'channel', desc: 'Channel, private group, or DM channel to send message to. Can be an encoded ID, or a name. See below for more details.'
-          c.flag 'post_at', desc: 'Unix timestamp representing the future time the message should post to Slack.'
+          c.flag 'as_user', desc: 'Set to true to post the message as the authed user, instead of as a bot. Defaults to false. Cannot be used by new Slack apps. See chat.postMessage.'
           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 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
-          c.flag 'as_user', desc: 'Set to true to post the message as the authed user, instead of as a bot. Defaults to false. Cannot be used by new Slack apps. See chat.postMessage.'
+          c.flag 'channel', desc: 'Channel, private group, or DM channel to send message to. Can be an encoded ID, or a name. See below for more details.'
           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 'markdown_text', desc: 'Accepts message text formatted in markdown. This argument should not be used in conjunction with blocks or text. Limit this field to 12,000 characters.'
-          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 'parse', desc: 'Change how messages are treated. See chat.postMessage.'
+          c.flag 'post_at', desc: 'Unix timestamp representing the future time the message should post to Slack.'
           c.flag 'reply_broadcast', desc: 'Used in conjunction with thread_ts and indicates whether reply should be made visible to everyone in the channel or conversation. Defaults to false.'
+          c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
           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 '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.action do |_global_options, options, _args|
             puts JSON.dump(@client.chat_scheduleMessage(options))
           end
@@ -134,12 +133,12 @@ module Slack
           c.flag 'channel', desc: 'Channel ID of the message. Both channel and ts must be provided together, or unfurl_id and source must be provided together.'
           c.flag 'ts', desc: 'Timestamp of the message to add unfurl behavior to.'
           c.flag 'unfurls', desc: 'URL-encoded JSON map with keys set to URLs featured in the the message, pointing to their unfurl blocks or message attachments.'
-          c.flag 'source', desc: 'The source of the link to unfurl. The source may either be composer, when the link is inside the message composer, or conversations_history, when the link has been posted to a conversation.'
-          c.flag 'unfurl_id', desc: 'The ID of the link to unfurl. Both unfurl_id and source must be provided together, or channel and ts must be provided together.'
-          c.flag 'user_auth_blocks', desc: 'Provide a JSON based array of structured blocks presented as URL-encoded string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior.'
           c.flag 'user_auth_message', desc: 'Provide a simply-formatted string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior. Provides two buttons, Not now or Never ask me again.'
           c.flag 'user_auth_required', desc: 'Set to true or 1 to indicate the user must install your Slack app to trigger unfurls for this domain.'
           c.flag 'user_auth_url', desc: 'Send users to this custom URL where they will complete authentication in your app to fully trigger unfurling. Value should be properly URL-encoded.'
+          c.flag 'user_auth_blocks', desc: 'Provide a JSON based array of structured blocks presented as URL-encoded string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior.'
+          c.flag 'unfurl_id', desc: 'The ID of the link to unfurl. Both unfurl_id and source must be provided together, or channel and ts must be provided together.'
+          c.flag 'source', desc: 'The source of the link to unfurl. The source may either be composer, when the link is inside the message composer, or conversations_history, when the link has been posted to a conversation.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.chat_unfurl(options))
           end
@@ -148,18 +147,18 @@ module Slack
         g.desc 'Updates a message.'
         g.long_desc %( Updates a message. )
         g.command 'update' do |c|
-          c.flag 'channel', desc: 'Channel containing the message to be updated. For direct messages, ensure that this value is a DM ID (starts with D) instead of a User ID (starts with either U or W).'
-          c.flag 'ts', desc: 'Timestamp of the message to be updated.'
+          c.flag 'as_user', desc: 'Pass true to update the message as the authed user. Bot users in this context are considered authed users.'
           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 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
-          c.flag 'as_user', desc: 'Pass true to update the message as the authed user. Bot users in this context are considered authed users.'
-          c.flag 'file_ids', desc: 'Array of new file ids that will be sent with this message.'
-          c.flag 'link_names', desc: 'Find and link channel names and usernames. Defaults to none. If you do not specify a value for this field, the original value set for the message will be overwritten with the default, none.'
           c.flag 'markdown_text', desc: 'Accepts message text formatted in markdown. This argument should not be used in conjunction with blocks or text. Limit this field to 12,000 characters.'
           c.flag 'metadata', desc: "JSON object with event_type and event_payload fields, presented as a URL-encoded string. If you don't include this field, the message's previous metadata will be retained. To remove previous metadata, include an empty object for this field. Metadata you post to Slack is accessible to any app or user who is a member of that workspace."
+          c.flag 'channel', desc: 'Channel containing the message to be updated. For direct messages, ensure that this value is a DM ID (starts with D) instead of a User ID (starts with either U or W).'
+          c.flag 'link_names', desc: 'Find and link channel names and usernames. Defaults to none. If you do not specify a value for this field, the original value set for the message will be overwritten with the default, none.'
           c.flag 'parse', desc: 'Change how messages are treated. Defaults to client, unlike chat.postMessage. Accepts either none or full. If you do not specify a value for this field, the original value set for the message will be overwritten with the default, client.'
+          c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
+          c.flag 'ts', desc: 'Timestamp of the message to be updated.'
           c.flag 'reply_broadcast', desc: 'Broadcast an existing thread reply to make it visible to everyone in the channel or conversation.'
+          c.flag 'file_ids', desc: 'Array of new file ids that will be sent with this message.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.chat_update(options))
           end

data/bin/commands/conversations.rb

@@ -10,10 +10,10 @@ module Slack
         g.long_desc %( Accepts an invitation to a Slack Connect channel. )
         g.command 'acceptSharedInvite' do |c|
           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 'is_private', desc: 'Whether the channel should be private.'
           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: "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 'channel_id', desc: "ID of the channel that you'd like to accept. Must provide either invite_id or channel_id."
           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|
             puts JSON.dump(@client.conversations_acceptSharedInvite(options))
@@ -51,8 +51,8 @@ module Slack
         g.desc 'Initiates a public or private channel-based conversation'
         g.long_desc %( Initiates a public or private channel-based conversation )
         g.command 'create' do |c|
-          c.flag 'name', desc: 'Name of the public or private channel to create.'
           c.flag 'is_private', desc: 'Create a private channel instead of a public one.'
+          c.flag 'name', desc: 'Name of the public or private channel to create.'
           c.flag 'team_id', desc: 'encoded team id to create the channel in, required if org token is used.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_create(options))
@@ -99,8 +99,8 @@ module Slack
         g.long_desc %( Invites users to a channel. )
         g.command 'invite' do |c|
           c.flag 'channel', desc: 'The ID of the public or private channel to invite user(s) to.'
-          c.flag 'users', desc: 'A comma separated list of user IDs. Up to 1000 users may be listed.'
           c.flag 'force', desc: 'When set to true and multiple user IDs are provided, continue inviting the valid ones while disregarding invalid IDs. Defaults to false.'
+          c.flag 'users', desc: 'A comma separated list of user IDs. Up to 100 users may be listed.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_invite(options))
           end
@@ -111,8 +111,8 @@ module Slack
         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. 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 an 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. 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 an external limited member. Defaults to true.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_inviteShared(options))
           end
@@ -162,8 +162,8 @@ module Slack
         g.desc 'Lists shared channel invites that have been generated or received but have not been approved by all parties'
         g.long_desc %( Lists shared channel invites that have been generated or received but have not been approved by all parties )
         g.command 'listConnectInvites' do |c|
-          c.flag 'cursor', desc: 'Set to next_cursor returned by previous call to list items in subsequent page.'
           c.flag 'team_id', desc: 'Encoded team id for the workspace to retrieve invites for, required if org token is used.'
+          c.flag 'cursor', desc: 'Set to next_cursor returned by previous call to list items in subsequent page.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_listConnectInvites(options))
           end
@@ -194,9 +194,9 @@ module Slack
         g.long_desc %( Opens or resumes a direct message or multi-person direct message. )
         g.command 'open' do |c|
           c.flag 'channel', desc: "Resume a conversation by supplying an im or mpim's ID. Or provide the users field instead."
-          c.flag 'prevent_creation', desc: 'Do not create a direct message or multi-person direct message. This is used to see if there is an existing dm or mpdm.'
           c.flag 'return_im', desc: 'Boolean, indicates you want the full IM channel definition in the response.'
           c.flag 'users', desc: 'Comma separated lists of users. If only one user is included, this creates a 1:1 DM.  The ordering of the users is preserved whenever a multi-person direct message is returned. Supply a channel when not supplying users.'
+          c.flag 'prevent_creation', desc: 'Do not create a direct message or multi-person direct message. This is used to see if there is an existing dm or mpdm.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_open(options))
           end
@@ -216,13 +216,13 @@ module Slack
         g.long_desc %( Retrieve a thread of messages posted to a conversation )
         g.command 'replies' do |c|
           c.flag 'channel', desc: 'Conversation ID to fetch thread from.'
-          c.flag 'ts', desc: "Unique identifier of either a thread's parent message or a message in the thread. ts must be the timestamp of an existing message with 0 or more replies. If there are no replies then just the single message referenced by ts will return - it is just an ordinary, unthreaded message."
           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 'include_all_metadata', desc: 'Return all metadata associated with this message.'
           c.flag 'inclusive', desc: 'Include messages with oldest or latest timestamps in results. Ignored unless either timestamp is specified.'
           c.flag 'latest', desc: 'Only messages before this Unix timestamp will be included in results.'
           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 users list hasn't been reached."
           c.flag 'oldest', desc: 'Only messages after this Unix timestamp will be included in results.'
+          c.flag 'ts', desc: "Unique identifier of either a thread's parent message or a message in the thread. ts must be the timestamp of an existing message with 0 or more replies. If there are no replies then just the single message referenced by ts will return - it is just an ordinary, unthreaded message."
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_replies(options))
           end

data/bin/commands/conversations_canvases.rb

@@ -9,7 +9,7 @@ module Slack
         g.desc 'Create a channel canvas for a channel'
         g.long_desc %( Create a channel canvas for a channel )
         g.command 'create' do |c|
-          c.flag 'channel_id', desc: 'Channel ID of the channel we create the channel canvas for.'
+          c.flag 'channel_id', desc: 'Channel ID of the channel the canvas will be tabbed in.'
           c.flag 'document_content', desc: 'Structure describing the type and value of the content to create.'
           c.flag 'title', desc: 'Title of the newly created canvas.'
           c.action do |_global_options, options, _args|

data/bin/commands/conversations_externalInvitePermissions.rb

@@ -9,9 +9,9 @@ module Slack
         g.desc "Upgrade or downgrade Slack Connect channel permissions between 'can post only' and 'can post and invite'."
         g.long_desc %( Upgrade or downgrade Slack Connect channel permissions between 'can post only' and 'can post and invite'. )
         g.command 'set' do |c|
-          c.flag 'action', desc: 'Type of action to be taken: upgrade or downgrade.'
           c.flag 'channel', desc: 'The channel ID to change external invite permissions for.'
           c.flag 'target_team', desc: 'The encoded team ID of the target team.  Must be in the specified channel.'
+          c.flag 'action', desc: 'Type of action to be taken: upgrade or downgrade.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_externalInvitePermissions_set(options))
           end

data/bin/commands/conversations_requestSharedInvite.rb

@@ -10,8 +10,8 @@ module Slack
         g.long_desc %( Approves a request to add an external user to a channel and sends them a Slack Connect invite )
         g.command 'approve' do |c|
           c.flag 'invite_id', desc: 'ID of the requested shared channel invite to approve.'
-          c.flag 'channel_id', desc: 'Optional channel_id to which external user will be invited to. Will override the value on the requested invite.'
           c.flag 'is_external_limited', desc: 'Optional boolean on whether the invited team will have post-only permissions in the channel. Will override the value on the requested invite.'
+          c.flag 'channel_id', desc: 'Optional channel_id to which external user will be invited to. Will override the value on the requested invite.'
           c.flag 'message', desc: 'Object describing the text to send along with the invite. If this object is specified, both text and is_override are required properties. If is_override is set to true, text will override the original invitation message. Otherwise, text will be appended to the original invitation message. The total length of the message cannot exceed 560 characters. If is_override is set to false, the length of text and the user specified message on the invite request in total must be less than 560 characters.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_requestSharedInvite_approve(options))
@@ -31,13 +31,13 @@ module Slack
         g.desc 'Lists requests to add external users to channels with ability to filter.'
         g.long_desc %( Lists requests to add external users to channels with ability to filter. )
         g.command 'list' 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. See pagination for more detail."
+          c.flag 'user_id', desc: 'Optional filter to return invitation requests for the inviting user.'
+          c.flag 'include_expired', desc: 'When true expired invitation requests will be returned, otherwise they will be excluded.'
           c.flag 'include_approved', desc: 'When true approved invitation requests will be returned, otherwise they will be excluded.'
           c.flag 'include_denied', desc: 'When true denied invitation requests will be returned, otherwise they will be excluded.'
-          c.flag 'include_expired', desc: 'When true expired invitation requests will be returned, otherwise they will be excluded.'
           c.flag 'invite_ids', desc: 'An optional list of invitation ids to look up.'
           c.flag 'limit', desc: 'The number of items to return. Must be between 1 - 1000 (inclusive).'
-          c.flag 'user_id', desc: 'Optional filter to return invitation requests for the inviting user.'
+          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.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_requestSharedInvite_list(options))
           end

data/bin/commands/dnd.rb

@@ -25,8 +25,8 @@ module Slack
         g.desc "Retrieves a user's current Do Not Disturb status."
         g.long_desc %( Retrieves a user's current Do Not Disturb status. )
         g.command 'info' do |c|
-          c.flag 'team_id', desc: 'Encoded team id where passed in user param belongs, required if org token is used. If no user param is passed, then a team which has access to the app should be passed.'
           c.flag 'user', desc: 'User to fetch status for (defaults to current user).'
+          c.flag 'team_id', desc: 'Encoded team id where passed in user param belongs, required if org token is used. If no user param is passed, then a team which has access to the app should be passed.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.dnd_info(options))
           end