slack-ruby-client 2.6.0 → 3.0.0

data/lib/slack/web/api/endpoints/admin_users.rb

@@ -13,12 +13,12 @@ module Slack
           #   The ID (T1234) of the workspace.
           # @option options [Object] :user_id
           #   The ID of the user to add to the workspace.
-          # @option options [string] :channel_ids
-          #   Comma separated values of channel IDs to add user in the new workspace.
           # @option options [boolean] :is_restricted
           #   True if user should be added to the workspace as a guest.
           # @option options [boolean] :is_ultra_restricted
           #   True if user should be added to the workspace as a single-channel guest.
+          # @option options [string] :channel_ids
+          #   Comma separated values of channel IDs to add user in the new workspace.
           # @see https://api.slack.com/methods/admin.users.assign
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users/admin.users.assign.json
           def admin_users_assign(options = {})
@@ -30,48 +30,50 @@ module Slack
           #
           # Invite a user to a workspace.
           #
-          # @option options [string] :channel_ids
-          #   A comma-separated list of channel_ids for this user to join. At least one channel is required.
-          # @option options [string] :email
-          #   The email address of the person to invite.
           # @option options [Object] :team_id
           #   The ID (T1234) of the workspace.
+          # @option options [string] :email
+          #   The email address of the person to invite.
+          # @option options [string] :channel_ids
+          #   A comma-separated list of channel_ids for this user to join. At least one channel is required.
           # @option options [string] :custom_message
           #   An optional message to send to the user in the invite email.
-          # @option options [boolean] :email_password_policy_enabled
-          #   Allow invited user to sign in via email and password. Only available for Enterprise Grid teams via admin invite.
-          # @option options [string] :guest_expiration_ts
-          #   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.
-          # @option options [boolean] :is_restricted
-          #   Is this user a multi-channel guest user? (default: false).
-          # @option options [boolean] :is_ultra_restricted
-          #   Is this user a single channel guest user? (default: false).
           # @option options [string] :real_name
           #   Full name of the user.
           # @option options [boolean] :resend
           #   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).
+          # @option options [boolean] :is_restricted
+          #   Is this user a multi-channel guest user? (default: false).
+          # @option options [boolean] :is_ultra_restricted
+          #   Is this user a single channel guest user? (default: false).
+          # @option options [string] :guest_expiration_ts
+          #   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.
+          # @option options [boolean] :email_password_policy_enabled
+          #   Allow invited user to sign in via email and password. Only available for Enterprise org teams via admin invite.
           # @see https://api.slack.com/methods/admin.users.invite
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users/admin.users.invite.json
           def admin_users_invite(options = {})
-            raise ArgumentError, 'Required arguments :channel_ids missing' if options[:channel_ids].nil?
-            raise ArgumentError, 'Required arguments :email missing' if options[:email].nil?
             raise ArgumentError, 'Required arguments :team_id missing' if options[:team_id].nil?
+            raise ArgumentError, 'Required arguments :email missing' if options[:email].nil?
+            raise ArgumentError, 'Required arguments :channel_ids missing' if options[:channel_ids].nil?
             post('admin.users.invite', options)
           end
 
           #
           # List users on a workspace
           #
+          # @option options [Object] :team_id
+          #   The ID (T1234) of a workspace. Filters results to just the specified workspace.
           # @option options [string] :cursor
           #   Set cursor to next_cursor returned by the previous call to list items in the next page.
-          # @option options [boolean] :include_deactivated_user_workspaces
-          #   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.
           # @option options [boolean] :is_active
           #   If true, only active users will be returned. If false, only deactivated users will be returned. Default is true.
+          # @option options [boolean] :include_deactivated_user_workspaces
+          #   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.
+          # @option options [boolean] :only_guests
+          #   If true, returns only guests and their expiration dates that belong to the team_id.
           # @option options [integer] :limit
           #   Limit for how many users to be retrieved per page.
-          # @option options [Object] :team_id
-          #   The ID (T1234) of a workspace. Filters results to just the specified workspace.
           # @see https://api.slack.com/methods/admin.users.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users/admin.users.list.json
           def admin_users_list(options = {})
@@ -117,17 +119,17 @@ module Slack
           #
           # Set an expiration for a guest user
           #
-          # @option options [integer] :expiration_ts
-          #   Epoch timestamp in seconds when guest account should be disabled.
-          # @option options [string] :user_id
-          #   The ID of the user to set an expiration for.
           # @option options [Object] :team_id
           #   The ID (T1234) of the workspace.
+          # @option options [string] :user_id
+          #   The ID of the user to set an expiration for.
+          # @option options [integer] :expiration_ts
+          #   Epoch timestamp in seconds when guest account should be disabled.
           # @see https://api.slack.com/methods/admin.users.setExpiration
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users/admin.users.setExpiration.json
           def admin_users_setExpiration(options = {})
-            raise ArgumentError, 'Required arguments :expiration_ts missing' if options[:expiration_ts].nil?
             raise ArgumentError, 'Required arguments :user_id missing' if options[:user_id].nil?
+            raise ArgumentError, 'Required arguments :expiration_ts missing' if options[:expiration_ts].nil?
             post('admin.users.setExpiration', options)
           end
 

data/lib/slack/web/api/endpoints/admin_users_session.rb

@@ -33,13 +33,16 @@ module Slack
           #
           # Revoke a single session for a user. The user will be forced to login to Slack.
           #
-          # @option options [integer] :session_id
-          #   ID of the session to invalidate.
+          # @option options [Object] :team_id
+          #   ID of the workspace that the session belongs to.
           # @option options [Object] :user_id
           #   ID of the user that the session belongs to.
+          # @option options [integer] :session_id
+          #   ID of the session to invalidate.
           # @see https://api.slack.com/methods/admin.users.session.invalidate
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users.session/admin.users.session.invalidate.json
           def admin_users_session_invalidate(options = {})
+            raise ArgumentError, 'Required arguments :user_id missing' if options[:user_id].nil?
             raise ArgumentError, 'Required arguments :session_id missing' if options[:session_id].nil?
             post('admin.users.session.invalidate', options)
           end
@@ -47,14 +50,14 @@ module Slack
           #
           # List active user sessions for an organization
           #
-          # @option options [string] :cursor
-          #   Set cursor to next_cursor returned by the previous call to list items in the next page.
-          # @option options [integer] :limit
-          #   The maximum number of items to return. Must be between 1 - 1000 both inclusive.
           # @option options [string] :team_id
           #   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.
           # @option options [string] :user_id
           #   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.
+          # @option options [integer] :limit
+          #   The maximum number of items to return. Must be between 1 - 1000 both inclusive.
+          # @option options [string] :cursor
+          #   Set cursor to next_cursor returned by the previous call to list items in the next page.
           # @see https://api.slack.com/methods/admin.users.session.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users.session/admin.users.session.list.json
           def admin_users_session_list(options = {})
@@ -87,7 +90,7 @@ module Slack
           # Enqueues an asynchronous job to wipe all valid sessions on all devices for a given list of users
           #
           # @option options [array] :user_ids
-          #   The ID of the user to wipe sessions for.
+          #   The list of up to 1,000 user IDs to wipe sessions for.
           # @option options [boolean] :mobile_only
           #   Only expire mobile sessions (default: false).
           # @option options [boolean] :web_only
@@ -104,10 +107,10 @@ module Slack
           #
           # @option options [array] :user_ids
           #   The list of up to 1,000 user IDs to apply the session settings for.
-          # @option options [boolean] :desktop_app_browser_quit
-          #   Terminate the session when the client—either the desktop app or a browser window—is closed.
           # @option options [integer] :duration
           #   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).
+          # @option options [boolean] :desktop_app_browser_quit
+          #   Terminate the session when the client—either the desktop app or a browser window—is closed.
           # @see https://api.slack.com/methods/admin.users.session.setSettings
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users.session/admin.users.session.setSettings.json
           def admin_users_session_setSettings(options = {})

data/lib/slack/web/api/endpoints/admin_users_unsupportedVersions.rb

@@ -9,10 +9,10 @@ module Slack
           #
           # Ask Slackbot to send you an export listing all workspace members using unsupported software, presented as a zipped CSV file.
           #
-          # @option options [integer] :date_end_of_support
-          #   Unix timestamp of the date of past or upcoming end of support cycles. If not provided will include all announced end of support cycles.
           # @option options [integer] :date_sessions_started
           #   Unix timestamp of a date to start looking for user sessions. If not provided will start six months ago.
+          # @option options [integer] :date_end_of_support
+          #   Unix timestamp of the date of past or upcoming end of support cycles. If not provided will include all announced end of support cycles.
           # @see https://api.slack.com/methods/admin.users.unsupportedVersions.export
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users.unsupportedVersions/admin.users.unsupportedVersions.export.json
           def admin_users_unsupportedVersions_export(options = {})

data/lib/slack/web/api/endpoints/admin_workflows.rb

@@ -9,34 +9,34 @@ module Slack
           #
           # Search workflows within the team or enterprise
           #
+          # @option options [string] :query
+          #   A search query to filter for workflow name or description.
           # @option options [Object] :app_id
           #   The parent app ID for which to return workflows.
-          # @option options [array] :collaborator_ids
-          #   Only include workflows where all of the provided user IDs are a manager/collaborator of that workflow.
           # @option options [string] :cursor
           #   Set cursor to next_cursor returned by the previous call to list items in the next page.
-          # @option options [boolean] :is_sales_elevate
-          #   Filter workflows by their Sales Elevate status.
           # @option options [integer] :limit
           #   The number of results that will be returned by the API on each invocation.
           # @option options [boolean] :no_collaborators
           #   Only include workflows with no collaborators in the result; default is false.
+          # @option options [array] :collaborator_ids
+          #   Only include workflows where all of the provided user IDs are a manager/collaborator of that workflow.
           # @option options [integer] :num_trigger_ids
           #   Number of trigger IDs to fetch for each workflow; default is 10.
-          # @option options [enum] :publish_status
-          #   Filter workflows by their published status.
-          # @option options [string] :query
-          #   A search query to filter for workflow name or description.
+          # @option options [boolean] :is_sales_elevate
+          #   Filter workflows by their Sales Elevate status.
+          # @option options [enum] :source
+          #   Source of workflow creation, either from code or workflow builder.
           # @option options [enum] :sort
           #   The field used to sort the returned workflows.
           # @option options [enum] :sort_dir
           #   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).
-          # @option options [enum] :source
-          #   Source of workflow creation, either from code or workflow builder.
-          # @option options [array] :step_function_ids
-          #   Only include workflows that use all of the provided step function ids.
           # @option options [string] :trigger_type_id
           #   Only include workflows with this trigger type.
+          # @option options [enum] :publish_status
+          #   Filter workflows by their published status.
+          # @option options [array] :step_function_ids
+          #   Only include workflows that use all of the provided step function ids.
           # @see https://api.slack.com/methods/admin.workflows.search
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.workflows/admin.workflows.search.json
           def admin_workflows_search(options = {})

data/lib/slack/web/api/endpoints/admin_workflows_collaborators.rb

@@ -9,30 +9,30 @@ module Slack
           #
           # Add collaborators to workflows within the team or enterprise
           #
-          # @option options [array] :collaborator_ids
-          #   Array of collaborators (encoded user IDs) to add; max 50.
           # @option options [array] :workflow_ids
           #   Array of workflow IDs to edit; max 50.
+          # @option options [array] :collaborator_ids
+          #   Array of collaborators (encoded user IDs) to add; max 50.
           # @see https://api.slack.com/methods/admin.workflows.collaborators.add
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.workflows.collaborators/admin.workflows.collaborators.add.json
           def admin_workflows_collaborators_add(options = {})
-            raise ArgumentError, 'Required arguments :collaborator_ids missing' if options[:collaborator_ids].nil?
             raise ArgumentError, 'Required arguments :workflow_ids missing' if options[:workflow_ids].nil?
+            raise ArgumentError, 'Required arguments :collaborator_ids missing' if options[:collaborator_ids].nil?
             post('admin.workflows.collaborators.add', options)
           end
 
           #
           # Remove collaborators from workflows within the team or enterprise
           #
-          # @option options [array] :collaborator_ids
-          #   Array of collaborators (encoded user IDs) to remove; max 50.
           # @option options [array] :workflow_ids
           #   Array of workflow IDs to edit; max 50.
+          # @option options [array] :collaborator_ids
+          #   Array of collaborators (encoded user IDs) to remove; max 50.
           # @see https://api.slack.com/methods/admin.workflows.collaborators.remove
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.workflows.collaborators/admin.workflows.collaborators.remove.json
           def admin_workflows_collaborators_remove(options = {})
-            raise ArgumentError, 'Required arguments :collaborator_ids missing' if options[:collaborator_ids].nil?
             raise ArgumentError, 'Required arguments :workflow_ids missing' if options[:workflow_ids].nil?
+            raise ArgumentError, 'Required arguments :collaborator_ids missing' if options[:collaborator_ids].nil?
             post('admin.workflows.collaborators.remove', options)
           end
         end

data/lib/slack/web/api/endpoints/apps_activities.rb

@@ -11,30 +11,30 @@ module Slack
           #
           # @option options [Object] :app_id
           #   The id of the app to get activities from.
-          # @option options [string] :component_id
-          #   The component id of log events to be returned. Will be 'FnXXXXXX' for functions, and 'WfXXXXXX' for worflows.
-          # @option options [string] :component_type
-          #   The component type of log events to be returned. Acceptable values are ('events_api', 'workflows', 'functions', 'tables').
+          # @option options [string] :team_id
+          #   The team who owns this log.
           # @option options [string] :cursor
           #   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.
           # @option options [integer] :limit
           #   The maximum number of items to return.
-          # @option options [string] :log_event_type
-          #   The event type of log events to be returned.
-          # @option options [integer] :max_date_created
-          #   The latest timestamp of the log to retrieve (epoch microseconds).
-          # @option options [integer] :min_date_created
-          #   The earliest timestamp of the log to retrieve (epoch microseconds).
           # @option options [string] :min_log_level
           #   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').
-          # @option options [enum] :sort_direction
-          #   The direction you want the data sorted by (always by timestamp).
+          # @option options [string] :log_event_type
+          #   The event type of log events to be returned.
           # @option options [string] :source
           #   The source of log events to be returned. Acceptable values are ('slack', 'developer').
-          # @option options [string] :team_id
-          #   The team who owns this log.
+          # @option options [string] :component_type
+          #   The component type of log events to be returned. Acceptable values are ('events_api', 'workflows', 'functions', 'tables').
+          # @option options [string] :component_id
+          #   The component id of log events to be returned. Will be 'FnXXXXXX' for functions, and 'WfXXXXXX' for workflows.
           # @option options [string] :trace_id
           #   The trace id of log events to be returned.
+          # @option options [integer] :min_date_created
+          #   The earliest timestamp of the log to retrieve (epoch microseconds).
+          # @option options [integer] :max_date_created
+          #   The latest timestamp of the log to retrieve (epoch microseconds).
+          # @option options [enum] :sort_direction
+          #   The direction you want the data sorted by (always by timestamp).
           # @see https://api.slack.com/methods/apps.activities.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.activities/apps.activities.list.json
           def apps_activities_list(options = {})

data/lib/slack/web/api/endpoints/apps_auth_external.rb

@@ -11,10 +11,10 @@ module Slack
           #
           # @option options [string] :app_id
           #   The id of the app whose tokens you want to delete.
-          # @option options [string] :external_token_id
-          #   The id of the token that you want to delete.
           # @option options [string] :provider_key
           #   The provider key of the provider whose tokens you want to delete.
+          # @option options [string] :external_token_id
+          #   The id of the token that you want to delete.
           # @see https://api.slack.com/methods/apps.auth.external.delete
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.auth.external/apps.auth.external.delete.json
           def apps_auth_external_delete(options = {})

data/lib/slack/web/api/endpoints/apps_datastore.rb

@@ -14,7 +14,6 @@ module Slack
           # @option options [array] :ids
           #   IDs of items to be deleted.
           # @option options [Object] :app_id
-          #   .
           # @see https://api.slack.com/methods/apps.datastore.bulkDelete
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.datastore/apps.datastore.bulkDelete.json
           def apps_datastore_bulkDelete(options = {})
@@ -31,7 +30,6 @@ module Slack
           # @option options [array] :ids
           #   items' ids.
           # @option options [Object] :app_id
-          #   .
           # @see https://api.slack.com/methods/apps.datastore.bulkGet
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.datastore/apps.datastore.bulkGet.json
           def apps_datastore_bulkGet(options = {})
@@ -48,7 +46,6 @@ module Slack
           # @option options [array] :items
           #   attribute names and values of the items; limit of 25.
           # @option options [Object] :app_id
-          #   .
           # @see https://api.slack.com/methods/apps.datastore.bulkPut
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.datastore/apps.datastore.bulkPut.json
           def apps_datastore_bulkPut(options = {})
@@ -62,14 +59,14 @@ module Slack
           #
           # @option options [string] :datastore
           #   Name of the datastore.
-          # @option options [Object] :app_id
-          #   Required if calling with user token.
           # @option options [string] :expression
-          #   A query filter expression https://api.slack.com/future/datastores.
+          #   A query filter expression.
           # @option options [object] :expression_attributes
           #   A map of attributes referenced in expression.
           # @option options [object] :expression_values
           #   A map of values referenced in expression.
+          # @option options [Object] :app_id
+          #   Required if calling with user token.
           # @see https://api.slack.com/methods/apps.datastore.count
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.datastore/apps.datastore.count.json
           def apps_datastore_count(options = {})
@@ -85,7 +82,6 @@ module Slack
           # @option options [string] :id
           #   item id.
           # @option options [Object] :app_id
-          #   .
           # @see https://api.slack.com/methods/apps.datastore.delete
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.datastore/apps.datastore.delete.json
           def apps_datastore_delete(options = {})
@@ -102,7 +98,6 @@ module Slack
           # @option options [string] :id
           #   item id.
           # @option options [Object] :app_id
-          #   .
           # @see https://api.slack.com/methods/apps.datastore.get
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.datastore/apps.datastore.get.json
           def apps_datastore_get(options = {})
@@ -119,7 +114,6 @@ module Slack
           # @option options [object] :item
           #   attribute names and values of the item.
           # @option options [Object] :app_id
-          #   .
           # @see https://api.slack.com/methods/apps.datastore.put
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.datastore/apps.datastore.put.json
           def apps_datastore_put(options = {})
@@ -133,16 +127,16 @@ module Slack
           #
           # @option options [string] :datastore
           #   Name of the datastore.
-          # @option options [Object] :app_id
-          #   Required if calling with user token.
-          # @option options [string] :cursor
-          #   Set cursor to next_cursor returned by the previous call to list items in the next page.
           # @option options [string] :expression
-          #   A query filter expression https://api.slack.com/future/datastores.
+          #   A query filter expression.
           # @option options [object] :expression_attributes
           #   A map of attributes referenced in expression.
           # @option options [object] :expression_values
           #   A map of values referenced in expression.
+          # @option options [Object] :app_id
+          #   Required if calling with user token.
+          # @option options [string] :cursor
+          #   Set cursor to next_cursor returned by the previous call to list items in the next page.
           # @option options [integer] :limit
           #   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.
           # @see https://api.slack.com/methods/apps.datastore.query
@@ -166,7 +160,6 @@ module Slack
           # @option options [object] :item
           #   attribute names and values to be updated.
           # @option options [Object] :app_id
-          #   .
           # @see https://api.slack.com/methods/apps.datastore.update
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.datastore/apps.datastore.update.json
           def apps_datastore_update(options = {})

data/lib/slack/web/api/endpoints/apps_event_authorizations.rb

@@ -10,11 +10,8 @@ module Slack
           # Get a list of authorizations for the given event context. Each authorization represents an app installation that the event is visible to.
           #
           # @option options [string] :event_context
-          #   .
           # @option options [string] :cursor
-          #   .
           # @option options [integer] :limit
-          #   .
           # @see https://api.slack.com/methods/apps.event.authorizations.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.event.authorizations/apps.event.authorizations.list.json
           def apps_event_authorizations_list(options = {})

data/lib/slack/web/api/endpoints/apps_manifest.rb

@@ -9,7 +9,7 @@ module Slack
           #
           # Create an app from an app manifest.
           #
-          # @option options [manifest object as string] :manifest
+          # @option options [string] :manifest
           #   A JSON app manifest encoded as a string. This manifest must use a valid app manifest schema - read our guide to creating one.
           # @see https://api.slack.com/methods/apps.manifest.create
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.manifest/apps.manifest.create.json
@@ -46,15 +46,15 @@ module Slack
           #
           # Update an app from an app manifest
           #
+          # @option options [string] :manifest
+          #   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.
           # @option options [Object] :app_id
           #   The ID of the app whose configuration you want to update.
-          # @option options [manifest object as string] :manifest
-          #   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.
           # @see https://api.slack.com/methods/apps.manifest.update
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.manifest/apps.manifest.update.json
           def apps_manifest_update(options = {})
-            raise ArgumentError, 'Required arguments :app_id missing' if options[:app_id].nil?
             raise ArgumentError, 'Required arguments :manifest missing' if options[:manifest].nil?
+            raise ArgumentError, 'Required arguments :app_id missing' if options[:app_id].nil?
             options = encode_options_as_json(options, %i[manifest])
             post('apps.manifest.update', options)
           end
@@ -62,7 +62,7 @@ module Slack
           #
           # Validate an app manifest
           #
-          # @option options [manifest object as string] :manifest
+          # @option options [string] :manifest
           #   The manifest to be validated. Will be validated against the app manifest schema - read our guide.
           # @option options [Object] :app_id
           #   The ID of the app whose configuration you want to validate.

data/lib/slack/web/api/endpoints/assistant_search.rb

@@ -16,15 +16,31 @@ module Slack
           # @option options [array] :channel_types
           #   Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im.
           # @option options [array] :content_types
-          #   Content types to include, a comma-separated list of any combination of messages, files.
+          #   Content types to include, a comma-separated list of any combination of messages, files, channels, users.
+          # @option options [boolean] :include_bots
+          #   If you want the results to include bots.
+          # @option options [integer] :before
+          #   UNIX timestamp filter. If present, filters for results before this date.
+          # @option options [integer] :after
+          #   UNIX timestamp filter. If present, filters for results after this date.
+          # @option options [boolean] :include_context_messages
+          #   Whether to include context messages surrounding the main message result. Defaults to false if unspecified.
           # @option options [Object] :context_channel_id
           #   Context channel ID to support scoping the search when applicable.
           # @option options [string] :cursor
           #   The cursor returned by the API. Leave this blank for the first request, and use this to get the next page of results.
-          # @option options [boolean] :include_bots
-          #   If you want the results to include bots.
           # @option options [integer] :limit
           #   Number of results to return, up to a max of 20. Defaults to 20.
+          # @option options [enum] :sort
+          #   The field to sort the results by. Defaults to score. Can be one of: score, timestamp.
+          # @option options [enum] :sort_dir
+          #   The direction to sort the results by. Defaults to desc.
+          # @option options [boolean] :include_message_blocks
+          #   Whether to return the message blocks in the response.
+          # @option options [boolean] :highlight
+          #   Whether to highlight the search query in the results. Defaults to false if unspecified.
+          # @option options [array] :term_clauses
+          #   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).
           # @see https://api.slack.com/methods/assistant.search.context
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/assistant.search/assistant.search.context.json
           def assistant_search_context(options = {})
@@ -37,6 +53,15 @@ module Slack
               post('assistant.search.context', options)
             end
           end
+
+          #
+          # Returns search capabilities on a given team.
+          #
+          # @see https://api.slack.com/methods/assistant.search.info
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/assistant.search/assistant.search.info.json
+          def assistant_search_info(options = {})
+            post('assistant.search.info', options)
+          end
         end
       end
     end

data/lib/slack/web/api/endpoints/assistant_threads.rb

@@ -11,16 +11,16 @@ module Slack
           #
           # @option options [Object] :channel_id
           #   Channel ID containing the assistant thread.
-          # @option options [string] :status
-          #   Status of the specified bot user, e.g. 'is thinking...'.
           # @option options [string] :thread_ts
           #   Message timestamp of the thread of where to set the status.
+          # @option options [string] :status
+          #   Status of the specified bot user, e.g. 'is thinking...'.
           # @see https://api.slack.com/methods/assistant.threads.setStatus
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/assistant.threads/assistant.threads.setStatus.json
           def assistant_threads_setStatus(options = {})
             raise ArgumentError, 'Required arguments :channel_id missing' if options[:channel_id].nil?
-            raise ArgumentError, 'Required arguments :status missing' if options[:status].nil?
             raise ArgumentError, 'Required arguments :thread_ts missing' if options[:thread_ts].nil?
+            raise ArgumentError, 'Required arguments :status missing' if options[:status].nil?
             post('assistant.threads.setStatus', options)
           end
 
@@ -29,18 +29,18 @@ module Slack
           #
           # @option options [Object] :channel_id
           #   Channel ID containing the assistant thread.
-          # @option options [Object] :prompts
-          #   Each prompt should be supplied with its title and message attribute.
           # @option options [string] :thread_ts
           #   Message timestamp of the thread to set suggested prompts for.
+          # @option options [Object] :prompts
+          #   Each prompt should be supplied with its title and message attribute.
           # @option options [string] :title
           #   Title for the list of provided prompts. For example: Suggested Prompts, Related Questions.
           # @see https://api.slack.com/methods/assistant.threads.setSuggestedPrompts
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/assistant.threads/assistant.threads.setSuggestedPrompts.json
           def assistant_threads_setSuggestedPrompts(options = {})
             raise ArgumentError, 'Required arguments :channel_id missing' if options[:channel_id].nil?
-            raise ArgumentError, 'Required arguments :prompts missing' if options[:prompts].nil?
             raise ArgumentError, 'Required arguments :thread_ts missing' if options[:thread_ts].nil?
+            raise ArgumentError, 'Required arguments :prompts missing' if options[:prompts].nil?
             post('assistant.threads.setSuggestedPrompts', options)
           end
 

data/lib/slack/web/api/endpoints/auth.rb

@@ -10,7 +10,7 @@ module Slack
           # Revokes a token.
           #
           # @option options [boolean] :test
-          #   Setting this parameter to 1 triggers a testing mode where the specified token will not actually be revoked.
+          #   Setting this parameter to 1 triggers a _testing mode_ where the specified token will not actually be revoked.
           # @see https://api.slack.com/methods/auth.revoke
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/auth/auth.revoke.json
           def auth_revoke(options = {})

data/lib/slack/web/api/endpoints/auth_teams.rb

@@ -9,12 +9,12 @@ module Slack
           #
           # Obtain a full list of workspaces your org-wide app has been approved for.
           #
+          # @option options [integer] :limit
+          #   The maximum number of workspaces to return. Must be a positive integer no larger than 1000.
           # @option options [string] :cursor
           #   Set cursor to next_cursor returned by the previous call to list items in the next page.
           # @option options [boolean] :include_icon
           #   Whether to return icon paths for each workspace. An icon path represents a URI pointing to the image signifying the workspace.
-          # @option options [integer] :limit
-          #   The maximum number of workspaces to return. Must be a positive integer no larger than 1000.
           # @see https://api.slack.com/methods/auth.teams.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/auth.teams/auth.teams.list.json
           def auth_teams_list(options = {})