slack-ruby-client 2.7.0 → 3.0.0

data/bin/commands/admin_teams_settings.rb

@@ -9,7 +9,7 @@ module Slack
         g.desc 'Fetch information about settings in a workspace'
         g.long_desc %( Fetch information about settings in a workspace )
         g.command 'info' do |c|
-          c.flag 'team_id', desc: '.'
+          c.flag 'team_id', desc: ''
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_teams_settings_info(options))
           end
@@ -18,8 +18,8 @@ module Slack
         g.desc 'Set the default channels of a workspace.'
         g.long_desc %( Set the default channels of a workspace. )
         g.command 'setDefaultChannels' do |c|
-          c.flag 'channel_ids', desc: 'An array of channel IDs.'
           c.flag 'team_id', desc: 'ID for the workspace to set the default channel for.'
+          c.flag 'channel_ids', desc: 'An array of channel IDs.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_teams_settings_setDefaultChannels(options))
           end
@@ -28,8 +28,8 @@ module Slack
         g.desc 'Set the description of a given workspace.'
         g.long_desc %( Set the description of a given workspace. )
         g.command 'setDescription' do |c|
-          c.flag 'description', desc: 'The new description for the workspace.'
           c.flag 'team_id', desc: 'ID for the workspace to set the description for.'
+          c.flag 'description', desc: 'The new description for the workspace.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_teams_settings_setDescription(options))
           end
@@ -38,8 +38,8 @@ module Slack
         g.desc 'An API method that allows admins to set the discoverability of a given workspace'
         g.long_desc %( An API method that allows admins to set the discoverability of a given workspace )
         g.command 'setDiscoverability' do |c|
-          c.flag 'discoverability', desc: "This workspace's discovery setting. It must be set to one of open, invite_only, closed, or unlisted."
           c.flag 'team_id', desc: 'The ID of the workspace to set discoverability on.'
+          c.flag 'discoverability', desc: "This workspace's discovery setting. It must be set to one of open, invite_only, closed, or unlisted."
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_teams_settings_setDiscoverability(options))
           end
@@ -58,8 +58,8 @@ module Slack
         g.desc 'Set the name of a given workspace.'
         g.long_desc %( Set the name of a given workspace. )
         g.command 'setName' do |c|
-          c.flag 'name', desc: 'The new name of the workspace.'
           c.flag 'team_id', desc: 'ID for the workspace to set the name for.'
+          c.flag 'name', desc: 'The new name of the workspace.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_teams_settings_setName(options))
           end

data/bin/commands/admin_usergroups.rb

@@ -9,9 +9,9 @@ module Slack
         g.desc 'Add up to one hundred default channels to an IDP group.'
         g.long_desc %( Add up to one hundred default channels to an IDP group. )
         g.command 'addChannels' do |c|
-          c.flag 'channel_ids', desc: 'Comma separated string of channel IDs.'
           c.flag 'usergroup_id', desc: 'ID of the IDP group to add default channels for.'
           c.flag 'team_id', desc: 'The workspace to add default channels in.'
+          c.flag 'channel_ids', desc: 'Comma separated string of channel IDs.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_usergroups_addChannels(options))
           end
@@ -20,8 +20,8 @@ module Slack
         g.desc 'Associate one or more default workspaces with an organization-wide IDP group.'
         g.long_desc %( Associate one or more default workspaces with an organization-wide IDP group. )
         g.command 'addTeams' do |c|
-          c.flag 'team_ids', desc: 'A comma separated list of encoded team (workspace) IDs. Each workspace MUST belong to the organization associated with the token.'
           c.flag 'usergroup_id', desc: 'An encoded usergroup (IDP Group) ID.'
+          c.flag 'team_ids', desc: 'A comma separated list of encoded team (workspace) IDs. Each workspace MUST belong to the organization associated with the token.'
           c.flag 'auto_provision', desc: 'When true, this method automatically creates new workspace accounts for the IDP group members.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_usergroups_addTeams(options))
@@ -32,8 +32,8 @@ module Slack
         g.long_desc %( List the channels linked to an org-level IDP group (user group). )
         g.command 'listChannels' do |c|
           c.flag 'usergroup_id', desc: 'ID of the IDP group to list default channels for.'
-          c.flag 'include_num_members', desc: 'Flag to include or exclude the count of members per channel.'
           c.flag 'team_id', desc: 'ID of the the workspace.'
+          c.flag 'include_num_members', desc: 'Flag to include or exclude the count of members per channel.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_usergroups_listChannels(options))
           end
@@ -42,8 +42,8 @@ module Slack
         g.desc 'Remove one or more default channels from an org-level IDP group (user group).'
         g.long_desc %( Remove one or more default channels from an org-level IDP group (user group). )
         g.command 'removeChannels' do |c|
-          c.flag 'channel_ids', desc: 'Comma-separated string of channel IDs.'
           c.flag 'usergroup_id', desc: 'ID of the IDP Group.'
+          c.flag 'channel_ids', desc: 'Comma-separated string of channel IDs.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_usergroups_removeChannels(options))
           end

data/bin/commands/admin_users.rb

@@ -11,9 +11,9 @@ module Slack
         g.command 'assign' do |c|
           c.flag 'team_id', desc: 'The ID (T1234) of the workspace.'
           c.flag 'user_id', desc: 'The ID of the user to add to the workspace.'
-          c.flag 'channel_ids', desc: 'Comma separated values of channel IDs to add user in the new workspace.'
           c.flag 'is_restricted', desc: 'True if user should be added to the workspace as a guest.'
           c.flag 'is_ultra_restricted', desc: 'True if user should be added to the workspace as a single-channel guest.'
+          c.flag 'channel_ids', desc: 'Comma separated values of channel IDs to add user in the new workspace.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_users_assign(options))
           end
@@ -22,16 +22,16 @@ module Slack
         g.desc 'Invite a user to a workspace.'
         g.long_desc %( Invite a user to a workspace. )
         g.command 'invite' do |c|
-          c.flag 'channel_ids', desc: 'A comma-separated list of channel_ids for this user to join. At least one channel is required.'
-          c.flag 'email', desc: 'The email address of the person to invite.'
           c.flag 'team_id', desc: 'The ID (T1234) of the workspace.'
+          c.flag 'email', desc: 'The email address of the person to invite.'
+          c.flag 'channel_ids', desc: 'A comma-separated list of channel_ids for this user to join. At least one channel is required.'
           c.flag 'custom_message', desc: 'An optional message to send to the user in the invite email.'
-          c.flag 'email_password_policy_enabled', desc: 'Allow invited user to sign in via email and password. Only available for Enterprise Grid teams via admin invite.'
-          c.flag 'guest_expiration_ts', desc: 'Timestamp when guest account should be disabled. Only include this timestamp if you are inviting a guest user and you want their account to expire on a certain date.'
-          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. Resending can only be done via the UI and has no expiration. (default: false).'
+          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 'guest_expiration_ts', desc: 'Timestamp when guest account should be disabled. Only include this timestamp if you are inviting a guest user and you want their account to expire on a certain date.'
+          c.flag 'email_password_policy_enabled', desc: 'Allow invited user to sign in via email and password. Only available for Enterprise org teams via admin invite.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_users_invite(options))
           end
@@ -40,11 +40,12 @@ module Slack
         g.desc 'List users on a workspace'
         g.long_desc %( List users on a workspace )
         g.command 'list' do |c|
+          c.flag 'team_id', desc: 'The ID (T1234) of a workspace. Filters results to just the specified workspace.'
           c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
-          c.flag 'include_deactivated_user_workspaces', desc: 'Only applies with org token and no team_id. If true, return workspaces for a user even if they may be deactivated on them. If false, return workspaces for a user only when user is active on them. Default is false.'
           c.flag 'is_active', desc: 'If true, only active users will be returned. If false, only deactivated users will be returned. Default is true.'
+          c.flag 'include_deactivated_user_workspaces', desc: 'Only applies with org token and no team_id. If true, return workspaces for a user even if they may be deactivated on them. If false, return workspaces for a user only when user is active on them. Default is false.'
+          c.flag 'only_guests', desc: 'If true, returns only guests and their expiration dates that belong to the team_id.'
           c.flag 'limit', desc: 'Limit for how many users to be retrieved per page.'
-          c.flag 'team_id', desc: 'The ID (T1234) of a workspace. Filters results to just the specified workspace.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_users_list(options))
           end
@@ -73,9 +74,9 @@ 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: '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.flag 'user_id', desc: 'The ID of the user to set an expiration for.'
+          c.flag 'expiration_ts', desc: 'Epoch timestamp in seconds when guest account should be disabled.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_users_setExpiration(options))
           end

data/bin/commands/admin_users_session.rb

@@ -27,8 +27,9 @@ module Slack
         g.desc 'Revoke a single session for a user. The user will be forced to login to Slack.'
         g.long_desc %( Revoke a single session for a user. The user will be forced to login to Slack. )
         g.command 'invalidate' do |c|
-          c.flag 'session_id', desc: 'ID of the session to invalidate.'
+          c.flag 'team_id', desc: 'ID of the workspace that the session belongs to.'
           c.flag 'user_id', desc: 'ID of the user that the session belongs to.'
+          c.flag 'session_id', desc: 'ID of the session to invalidate.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_users_session_invalidate(options))
           end
@@ -37,10 +38,10 @@ module Slack
         g.desc 'List active user sessions for an organization'
         g.long_desc %( List active user sessions for an 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 - 1000 both inclusive.'
           c.flag 'team_id', desc: "The ID of the workspace you'd like active sessions for. If you pass a team_id, you'll need to pass a user_id as well."
           c.flag 'user_id', desc: "The ID of user you'd like active sessions for. If you pass a user_id, you'll need to pass a team_id as well."
+          c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 - 1000 both inclusive.'
+          c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_users_session_list(options))
           end
@@ -60,7 +61,7 @@ module Slack
         g.desc 'Enqueues an asynchronous job to wipe all valid sessions on all devices for a given list of users'
         g.long_desc %( Enqueues an asynchronous job to wipe all valid sessions on all devices for a given list of users )
         g.command 'resetBulk' do |c|
-          c.flag 'user_ids', desc: 'The ID of the user to wipe sessions for.'
+          c.flag 'user_ids', desc: 'The list of up to 1,000 user IDs to wipe sessions for.'
           c.flag 'mobile_only', desc: 'Only expire mobile sessions (default: false).'
           c.flag 'web_only', desc: 'Only expire web sessions (default: false).'
           c.action do |_global_options, options, _args|
@@ -72,8 +73,8 @@ module Slack
         g.long_desc %( Configure the user-level session settings—the session duration and what happens when the client closes—for one or more users. )
         g.command 'setSettings' do |c|
           c.flag 'user_ids', desc: 'The list of up to 1,000 user IDs to apply the session settings for.'
-          c.flag 'desktop_app_browser_quit', desc: 'Terminate the session when the client—either the desktop app or a browser window—is closed.'
           c.flag 'duration', desc: "The session duration, in seconds. The minimum value is 28800, which represents 8 hours; the max value is 315569520 or 10 years (that's a long Slack session)."
+          c.flag 'desktop_app_browser_quit', desc: 'Terminate the session when the client—either the desktop app or a browser window—is closed.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_users_session_setSettings(options))
           end

data/bin/commands/admin_users_unsupportedVersions.rb

@@ -9,8 +9,8 @@ module Slack
         g.desc 'Ask Slackbot to send you an export listing all workspace members using unsupported software, presented as a zipped CSV file.'
         g.long_desc %( Ask Slackbot to send you an export listing all workspace members using unsupported software, presented as a zipped CSV file. )
         g.command 'export' do |c|
-          c.flag 'date_end_of_support', desc: 'Unix timestamp of the date of past or upcoming end of support cycles. If not provided will include all announced end of support cycles.'
           c.flag 'date_sessions_started', desc: 'Unix timestamp of a date to start looking for user sessions. If not provided will start six months ago.'
+          c.flag 'date_end_of_support', desc: 'Unix timestamp of the date of past or upcoming end of support cycles. If not provided will include all announced end of support cycles.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_users_unsupportedVersions_export(options))
           end

data/bin/commands/admin_workflows.rb

@@ -9,20 +9,20 @@ module Slack
         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 'query', desc: 'A search query to filter for workflow name or description.'
           c.flag 'app_id', desc: 'The parent app ID for which to return workflows.'
-          c.flag 'collaborator_ids', desc: 'Only include workflows where all of the provided user IDs are a manager/collaborator of that workflow.'
           c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
-          c.flag 'is_sales_elevate', desc: 'Filter workflows by their Sales Elevate status.'
           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 'collaborator_ids', desc: 'Only include workflows where all of the provided user IDs are a manager/collaborator of that workflow.'
           c.flag 'num_trigger_ids', desc: 'Number of trigger IDs to fetch for each workflow; default is 10.'
-          c.flag 'publish_status', desc: 'Filter workflows by their published status.'
-          c.flag 'query', desc: 'A search query to filter for workflow name or description.'
+          c.flag 'is_sales_elevate', desc: 'Filter workflows by their Sales Elevate status.'
+          c.flag 'source', desc: 'Source of workflow creation, either from code or workflow builder.'
           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.flag 'step_function_ids', desc: 'Only include workflows that use all of the provided step function ids.'
           c.flag 'trigger_type_id', desc: 'Only include workflows with this trigger type.'
+          c.flag 'publish_status', desc: 'Filter workflows by their published status.'
+          c.flag 'step_function_ids', desc: 'Only include workflows that use all of the provided step function ids.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_workflows_search(options))
           end

data/bin/commands/admin_workflows_collaborators.rb

@@ -9,8 +9,8 @@ module Slack
         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.flag 'collaborator_ids', desc: 'Array of collaborators (encoded user IDs) to add; max 50.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_workflows_collaborators_add(options))
           end
@@ -19,8 +19,8 @@ module Slack
         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.flag 'collaborator_ids', desc: 'Array of collaborators (encoded user IDs) to remove; max 50.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_workflows_collaborators_remove(options))
           end

data/bin/commands/apps_activities.rb

@@ -10,18 +10,18 @@ module Slack
         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 'team_id', desc: 'The team who owns this log.'
           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 'log_event_type', desc: 'The event type of log events to be returned.'
           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 'component_type', desc: "The component type of log events to be returned. Acceptable values are ('events_api', 'workflows', 'functions', 'tables')."
+          c.flag 'component_id', desc: "The component id of log events to be returned. Will be 'FnXXXXXX' for functions, and 'WfXXXXXX' for workflows."
           c.flag 'trace_id', desc: 'The trace id of log events to be returned.'
+          c.flag 'min_date_created', desc: 'The earliest timestamp of the log to retrieve (epoch microseconds).'
+          c.flag 'max_date_created', desc: 'The latest timestamp of the log to retrieve (epoch microseconds).'
+          c.flag 'sort_direction', desc: 'The direction you want the data sorted by (always by timestamp).'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.apps_activities_list(options))
           end

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|