slack-ruby-client 2.7.0 → 3.1.0

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

@@ -7,16 +7,18 @@ module Slack
       module Endpoints
         module AdminFunctions
           #
-          # Look up functions by a set of apps
+          # Look up functions by a set of apps.
           #
+          # @option options [Object] :team_id
+          #   The team context to retrieve functions from.
           # @option options [array] :app_ids
           #   Comma-separated array of app IDs to get functions for; max 50.
+          # @option options [boolean] :include_non_distributed_functions
+          #   Whether to also include functions that are not yet distributed to any users in the function count. This is needed for admins that are approving an app request and will only work if the team owns the app.
           # @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 number of results that will be returned by the API on each invocation. Must be between 1 and 1000, both inclusive.
-          # @option options [Object] :team_id
-          #   The team context to retrieve functions from.
           # @see https://api.slack.com/methods/admin.functions.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.functions/admin.functions.list.json
           def admin_functions_list(options = {})

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

@@ -19,7 +19,7 @@ module Slack
           end
 
           #
-          # Set the visibility of a Slack function and define the users or workspaces if it is set to named_entities
+          # Set the visibility of a Slack function and define the users or workspaces if it is set to named_entities.
           #
           # @option options [string] :function_id
           #   The function ID to set permissions for.

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

@@ -9,10 +9,10 @@ module Slack
           #
           # Approve a workspace invite request.
           #
-          # @option options [string] :invite_request_id
-          #   ID of the request to invite.
           # @option options [string] :team_id
           #   ID for the workspace where the invite request was made.
+          # @option options [string] :invite_request_id
+          #   ID of the request to invite.
           # @see https://api.slack.com/methods/admin.inviteRequests.approve
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.inviteRequests/admin.inviteRequests.approve.json
           def admin_inviteRequests_approve(options = {})
@@ -23,10 +23,10 @@ module Slack
           #
           # Deny a workspace invite request.
           #
-          # @option options [string] :invite_request_id
-          #   ID of the request to invite.
           # @option options [string] :team_id
           #   ID for the workspace where the invite request was made.
+          # @option options [string] :invite_request_id
+          #   ID of the request to invite.
           # @see https://api.slack.com/methods/admin.inviteRequests.deny
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.inviteRequests/admin.inviteRequests.deny.json
           def admin_inviteRequests_deny(options = {})
@@ -37,12 +37,12 @@ module Slack
           #
           # List all pending workspace invite requests.
           #
+          # @option options [string] :team_id
+          #   ID for the workspace where the invite requests were made.
           # @option options [string] :cursor
           #   Value of the next_cursor field sent as part of the previous API response.
           # @option options [integer] :limit
           #   The number of results that will be returned by the API on each invocation. Must be between 1 - 1000, both inclusive.
-          # @option options [string] :team_id
-          #   ID for the workspace where the invite requests were made.
           # @see https://api.slack.com/methods/admin.inviteRequests.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.inviteRequests/admin.inviteRequests.list.json
           def admin_inviteRequests_list(options = {})

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

@@ -9,12 +9,12 @@ module Slack
           #
           # List all approved workspace invite requests.
           #
+          # @option options [string] :team_id
+          #   ID for the workspace where the invite requests were made.
           # @option options [string] :cursor
           #   Value of the next_cursor field sent as part of the previous API response.
           # @option options [integer] :limit
           #   The number of results that will be returned by the API on each invocation. Must be between 1 - 1000, both inclusive.
-          # @option options [string] :team_id
-          #   ID for the workspace where the invite requests were made.
           # @see https://api.slack.com/methods/admin.inviteRequests.approved.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.inviteRequests.approved/admin.inviteRequests.approved.list.json
           def admin_inviteRequests_approved_list(options = {})

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

@@ -9,12 +9,12 @@ module Slack
           #
           # List all denied workspace invite requests.
           #
+          # @option options [Object] :team_id
+          #   ID for the workspace where the invite requests were made.
           # @option options [string] :cursor
           #   Value of the next_cursor field sent as part of the previous api response.
           # @option options [integer] :limit
           #   The number of results that will be returned by the API on each invocation. Must be between 1 - 1000 both inclusive.
-          # @option options [Object] :team_id
-          #   ID for the workspace where the invite requests were made.
           # @see https://api.slack.com/methods/admin.inviteRequests.denied.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.inviteRequests.denied/admin.inviteRequests.denied.list.json
           def admin_inviteRequests_denied_list(options = {})

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

@@ -9,17 +9,17 @@ module Slack
           #
           # Adds members to the specified role with the specified scopes
           #
-          # @option options [array] :entity_ids
-          #   List of the entity IDs for which roles will be assigned. These can be Org IDs, Team IDs or Channel IDs.
           # @option options [string] :role_id
           #   ID of the role to which users will be assigned.
+          # @option options [array] :entity_ids
+          #   List of the entity IDs for which roles will be assigned. These can be Org IDs, Team IDs or Channel IDs.
           # @option options [array] :user_ids
           #   List of IDs from the users to be added to the given role.
           # @see https://api.slack.com/methods/admin.roles.addAssignments
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.roles/admin.roles.addAssignments.json
           def admin_roles_addAssignments(options = {})
-            raise ArgumentError, 'Required arguments :entity_ids missing' if options[:entity_ids].nil?
             raise ArgumentError, 'Required arguments :role_id missing' if options[:role_id].nil?
+            raise ArgumentError, 'Required arguments :entity_ids missing' if options[:entity_ids].nil?
             raise ArgumentError, 'Required arguments :user_ids missing' if options[:user_ids].nil?
             post('admin.roles.addAssignments', options)
           end
@@ -29,12 +29,12 @@ module Slack
           #
           # @option options [string] :cursor
           #   Set cursor to next_cursor returned by the previous call to list items in the next page.
-          # @option options [array] :entity_ids
-          #   The entities for which the roles apply.
           # @option options [integer] :limit
           #   The maximum number of items to return. Must be between 1 - 200 both inclusive.
           # @option options [array] :role_ids
           #   collection of role ids to scope results by.
+          # @option options [array] :entity_ids
+          #   The entities for which the roles apply.
           # @option options [string] :sort_dir
           #   Sort direction. Default is descending on date_create, can be either ASC or DESC.
           # @see https://api.slack.com/methods/admin.roles.listAssignments
@@ -52,17 +52,17 @@ module Slack
           #
           # Removes a set of users from a role for the given scopes and entities
           #
-          # @option options [array] :entity_ids
-          #   List of the entity IDs for which roles will be revoked. These can be Org IDs, Team IDs or Channel IDs.
           # @option options [string] :role_id
           #   ID of the role to which users will be assigned.
+          # @option options [array] :entity_ids
+          #   List of the entity IDs for which roles will be revoked. These can be Org IDs, Team IDs or Channel IDs.
           # @option options [array] :user_ids
           #   List of IDs of the users whose roles will be revoked.
           # @see https://api.slack.com/methods/admin.roles.removeAssignments
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.roles/admin.roles.removeAssignments.json
           def admin_roles_removeAssignments(options = {})
-            raise ArgumentError, 'Required arguments :entity_ids missing' if options[:entity_ids].nil?
             raise ArgumentError, 'Required arguments :role_id missing' if options[:role_id].nil?
+            raise ArgumentError, 'Required arguments :entity_ids missing' if options[:entity_ids].nil?
             raise ArgumentError, 'Required arguments :user_ids missing' if options[:user_ids].nil?
             post('admin.roles.removeAssignments', options)
           end

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

@@ -26,12 +26,12 @@ module Slack
           end
 
           #
-          # List all teams on an Enterprise organization
+          # List all teams in an Enterprise 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 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.
           # @see https://api.slack.com/methods/admin.teams.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.teams/admin.teams.list.json
           def admin_teams_list(options = {})

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

@@ -9,12 +9,11 @@ module Slack
           #
           # List all of the admins on a given workspace.
           #
-          # @option options [Object] :team_id
-          #   .
-          # @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.
+          # @option options [string] :cursor
+          #   Set cursor to next_cursor returned by the previous call to list items in the next page.
+          # @option options [Object] :team_id
           # @see https://api.slack.com/methods/admin.teams.admins.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.teams.admins/admin.teams.admins.list.json
           def admin_teams_admins_list(options = {})

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

@@ -10,11 +10,10 @@ module Slack
           # List all of the owners on a given workspace.
           #
           # @option options [Object] :team_id
-          #   .
-          # @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] :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.teams.owners.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.teams.owners/admin.teams.owners.list.json
           def admin_teams_owners_list(options = {})

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

@@ -10,7 +10,6 @@ module Slack
           # Fetch information about settings in a workspace
           #
           # @option options [Object] :team_id
-          #   .
           # @see https://api.slack.com/methods/admin.teams.settings.info
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.teams.settings/admin.teams.settings.info.json
           def admin_teams_settings_info(options = {})
@@ -21,45 +20,45 @@ module Slack
           #
           # Set the default channels of a workspace.
           #
-          # @option options [array] :channel_ids
-          #   An array of channel IDs.
           # @option options [Object] :team_id
           #   ID for the workspace to set the default channel for.
+          # @option options [array] :channel_ids
+          #   An array of channel IDs.
           # @see https://api.slack.com/methods/admin.teams.settings.setDefaultChannels
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.teams.settings/admin.teams.settings.setDefaultChannels.json
           def admin_teams_settings_setDefaultChannels(options = {})
-            raise ArgumentError, 'Required arguments :channel_ids missing' if options[:channel_ids].nil?
             raise ArgumentError, 'Required arguments :team_id missing' if options[:team_id].nil?
+            raise ArgumentError, 'Required arguments :channel_ids missing' if options[:channel_ids].nil?
             post('admin.teams.settings.setDefaultChannels', options)
           end
 
           #
           # Set the description of a given workspace.
           #
-          # @option options [string] :description
-          #   The new description for the workspace.
           # @option options [Object] :team_id
           #   ID for the workspace to set the description for.
+          # @option options [string] :description
+          #   The new description for the workspace.
           # @see https://api.slack.com/methods/admin.teams.settings.setDescription
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.teams.settings/admin.teams.settings.setDescription.json
           def admin_teams_settings_setDescription(options = {})
-            raise ArgumentError, 'Required arguments :description missing' if options[:description].nil?
             raise ArgumentError, 'Required arguments :team_id missing' if options[:team_id].nil?
+            raise ArgumentError, 'Required arguments :description missing' if options[:description].nil?
             post('admin.teams.settings.setDescription', options)
           end
 
           #
           # An API method that allows admins to set the discoverability of a given workspace
           #
-          # @option options [string] :discoverability
-          #   This workspace's discovery setting. It must be set to one of open, invite_only, closed, or unlisted.
           # @option options [Object] :team_id
           #   The ID of the workspace to set discoverability on.
+          # @option options [string] :discoverability
+          #   This workspace's discovery setting. It must be set to one of open, invite_only, closed, or unlisted.
           # @see https://api.slack.com/methods/admin.teams.settings.setDiscoverability
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.teams.settings/admin.teams.settings.setDiscoverability.json
           def admin_teams_settings_setDiscoverability(options = {})
-            raise ArgumentError, 'Required arguments :discoverability missing' if options[:discoverability].nil?
             raise ArgumentError, 'Required arguments :team_id missing' if options[:team_id].nil?
+            raise ArgumentError, 'Required arguments :discoverability missing' if options[:discoverability].nil?
             post('admin.teams.settings.setDiscoverability', options)
           end
 
@@ -81,15 +80,15 @@ module Slack
           #
           # Set the name of a given workspace.
           #
-          # @option options [string] :name
-          #   The new name of the workspace.
           # @option options [Object] :team_id
           #   ID for the workspace to set the name for.
+          # @option options [string] :name
+          #   The new name of the workspace.
           # @see https://api.slack.com/methods/admin.teams.settings.setName
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.teams.settings/admin.teams.settings.setName.json
           def admin_teams_settings_setName(options = {})
-            raise ArgumentError, 'Required arguments :name missing' if options[:name].nil?
             raise ArgumentError, 'Required arguments :team_id missing' if options[:team_id].nil?
+            raise ArgumentError, 'Required arguments :name missing' if options[:name].nil?
             post('admin.teams.settings.setName', options)
           end
         end

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

@@ -9,34 +9,34 @@ module Slack
           #
           # Add up to one hundred default channels to an IDP group.
           #
-          # @option options [array] :channel_ids
-          #   Comma separated string of channel IDs.
           # @option options [string] :usergroup_id
           #   ID of the IDP group to add default channels for.
           # @option options [string] :team_id
           #   The workspace to add default channels in.
+          # @option options [array] :channel_ids
+          #   Comma separated string of channel IDs.
           # @see https://api.slack.com/methods/admin.usergroups.addChannels
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.addChannels.json
           def admin_usergroups_addChannels(options = {})
-            raise ArgumentError, 'Required arguments :channel_ids missing' if options[:channel_ids].nil?
             raise ArgumentError, 'Required arguments :usergroup_id missing' if options[:usergroup_id].nil?
+            raise ArgumentError, 'Required arguments :channel_ids missing' if options[:channel_ids].nil?
             post('admin.usergroups.addChannels', options)
           end
 
           #
           # Associate one or more default workspaces with an organization-wide IDP group.
           #
-          # @option options [array] :team_ids
-          #   A comma separated list of encoded team (workspace) IDs. Each workspace MUST belong to the organization associated with the token.
           # @option options [string] :usergroup_id
           #   An encoded usergroup (IDP Group) ID.
+          # @option options [array] :team_ids
+          #   A comma separated list of encoded team (workspace) IDs. Each workspace MUST belong to the organization associated with the token.
           # @option options [boolean] :auto_provision
           #   When true, this method automatically creates new workspace accounts for the IDP group members.
           # @see https://api.slack.com/methods/admin.usergroups.addTeams
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.addTeams.json
           def admin_usergroups_addTeams(options = {})
-            raise ArgumentError, 'Required arguments :team_ids missing' if options[:team_ids].nil?
             raise ArgumentError, 'Required arguments :usergroup_id missing' if options[:usergroup_id].nil?
+            raise ArgumentError, 'Required arguments :team_ids missing' if options[:team_ids].nil?
             post('admin.usergroups.addTeams', options)
           end
 
@@ -45,10 +45,10 @@ module Slack
           #
           # @option options [Object] :usergroup_id
           #   ID of the IDP group to list default channels for.
-          # @option options [boolean] :include_num_members
-          #   Flag to include or exclude the count of members per channel.
           # @option options [string] :team_id
           #   ID of the the workspace.
+          # @option options [boolean] :include_num_members
+          #   Flag to include or exclude the count of members per channel.
           # @see https://api.slack.com/methods/admin.usergroups.listChannels
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.listChannels.json
           def admin_usergroups_listChannels(options = {})
@@ -59,15 +59,15 @@ module Slack
           #
           # Remove one or more default channels from an org-level IDP group (user group).
           #
-          # @option options [array] :channel_ids
-          #   Comma-separated string of channel IDs.
           # @option options [string] :usergroup_id
           #   ID of the IDP Group.
+          # @option options [array] :channel_ids
+          #   Comma-separated string of channel IDs.
           # @see https://api.slack.com/methods/admin.usergroups.removeChannels
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.removeChannels.json
           def admin_usergroups_removeChannels(options = {})
-            raise ArgumentError, 'Required arguments :channel_ids missing' if options[:channel_ids].nil?
             raise ArgumentError, 'Required arguments :usergroup_id missing' if options[:usergroup_id].nil?
+            raise ArgumentError, 'Required arguments :channel_ids missing' if options[:channel_ids].nil?
             post('admin.usergroups.removeChannels', options)
           end
         end

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 = {})
@@ -27,51 +27,66 @@ module Slack
             post('admin.users.assign', options)
           end
 
+          #
+          # Fetches the expiration timestamp for a guest
+          #
+          # @option options [Object] :user_id
+          #   The ID of the guest user to get the expiration for.
+          # @option options [Object] :target_team
+          #   If an org token is passed in and this team is on the org, it will operate on the workspace level on the specified team. Otherwise it will operate on the org or team in context.
+          # @see https://api.slack.com/methods/admin.users.getExpiration
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users/admin.users.getExpiration.json
+          def admin_users_getExpiration(options = {})
+            post('admin.users.getExpiration', options)
+          end
+
           #
           # 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 +132,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 = {})