slack-ruby-client 3.2.0 → 3.3.0

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

@@ -40,6 +40,52 @@ module Slack
             post('admin.usergroups.addTeams', options)
           end
 
+          #
+          # Add members to an existing organizational usergroup. This method is only available to Enterprise Grid organizations.
+          #
+          # @option options [string] :id
+          #   ID of the usergroup to add users to.
+          # @option options [array] :users
+          #   The encoded user IDs to add to the usergroup, provided as a JSON array or a comma-separated string.
+          # @see https://api.slack.com/methods/admin.usergroups.addUsers
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.addUsers.json
+          def admin_usergroups_addUsers(options = {})
+            raise ArgumentError, 'Required arguments :id missing' if options[:id].nil?
+            raise ArgumentError, 'Required arguments :users missing' if options[:users].nil?
+            options = encode_options_as_json(options, %i[users])
+            post('admin.usergroups.addUsers', options)
+          end
+
+          #
+          # Create a new organizational usergroup. This method is only available to Enterprise Grid organizations.
+          #
+          # @option options [string] :name
+          #   Unique name for the usergroup.
+          # @option options [string] :handle
+          #   Optional handle used to mention the usergroup in channel, must be unique.
+          # @option options [string] :purpose
+          #   Optional purpose that describes what the usergroup is about.
+          # @option options [boolean] :is_visible
+          #   Configure whether or not this usergroup should be visible in the client.
+          # @see https://api.slack.com/methods/admin.usergroups.create
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.create.json
+          def admin_usergroups_create(options = {})
+            raise ArgumentError, 'Required arguments :name missing' if options[:name].nil?
+            post('admin.usergroups.create', options)
+          end
+
+          #
+          # Fetch an organizational usergroup.
+          #
+          # @option options [string] :id
+          #   ID of the usergroup to fetch.
+          # @see https://api.slack.com/methods/admin.usergroups.fetch
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.fetch.json
+          def admin_usergroups_fetch(options = {})
+            raise ArgumentError, 'Required arguments :id missing' if options[:id].nil?
+            post('admin.usergroups.fetch', options)
+          end
+
           #
           # List the channels linked to an org-level IDP group (user group).
           #
@@ -70,6 +116,71 @@ module Slack
             raise ArgumentError, 'Required arguments :channel_ids missing' if options[:channel_ids].nil?
             post('admin.usergroups.removeChannels', options)
           end
+
+          #
+          # Remove one or more default workspaces from an organization-wide IDP Group or Admin Group.
+          #
+          # @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.
+          # @see https://api.slack.com/methods/admin.usergroups.removeTeams
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.removeTeams.json
+          def admin_usergroups_removeTeams(options = {})
+            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.removeTeams', options)
+          end
+
+          #
+          # Remove members from an existing organizational usergroup. This method is only available to Enterprise Grid organizations.
+          #
+          # @option options [string] :id
+          #   ID of the usergroup to remove users from.
+          # @option options [array] :users
+          #   The encoded user IDs to remove from the usergroup, provided as a JSON array or a comma-separated string.
+          # @see https://api.slack.com/methods/admin.usergroups.removeUsers
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.removeUsers.json
+          def admin_usergroups_removeUsers(options = {})
+            raise ArgumentError, 'Required arguments :id missing' if options[:id].nil?
+            raise ArgumentError, 'Required arguments :users missing' if options[:users].nil?
+            options = encode_options_as_json(options, %i[users])
+            post('admin.usergroups.removeUsers', options)
+          end
+
+          #
+          # Update one or more properties of an existing organizational usergroup.
+          #
+          # @option options [string] :id
+          #   ID of the usergroup to update.
+          # @option options [string] :name
+          #   The name of the group.
+          # @option options [string] :handle
+          #   The handle used for mentioning the group in a channel, must be unique.
+          # @option options [string] :description
+          #   The usergroup's purpose or description.
+          # @option options [boolean] :is_visible
+          #   Configure whether or not this usergroup should be visible in the client.
+          # @see https://api.slack.com/methods/admin.usergroups.update
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.update.json
+          def admin_usergroups_update(options = {})
+            raise ArgumentError, 'Required arguments :id missing' if options[:id].nil?
+            post('admin.usergroups.update', options)
+          end
+
+          #
+          # Add members to an existing organizational usergroup in bulk via CSV upload. This method is only available to Enterprise Grid organizations.
+          #
+          # @option options [string] :id
+          #   ID of the usergroup to upload users to.
+          # @option options [file] :file
+          #   Csv of users to upload in format member id, email.
+          # @see https://api.slack.com/methods/admin.usergroups.uploadUsers
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.uploadUsers.json
+          def admin_usergroups_uploadUsers(options = {})
+            raise ArgumentError, 'Required arguments :id missing' if options[:id].nil?
+            post('admin.usergroups.uploadUsers', options)
+          end
         end
       end
     end

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

@@ -37,6 +37,7 @@ module Slack
           # @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 = {})
+            raise ArgumentError, 'Required arguments :user_id missing' if options[:user_id].nil?
             post('admin.users.getExpiration', options)
           end
 

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

@@ -33,8 +33,6 @@ module Slack
           #
           # Revoke a single session for a user. The user will be forced to login to Slack.
           #
-          # @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

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

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AgentsSessions
+          #
+          # Rename an agent session.
+          #
+          # @option options [string] :channel_id
+          #   ID of the channel containing the agent session. Required for public channels.
+          # @option options [string] :title
+          #   New title for the agent session (1-200 characters). For a session channel, this also renames the channel.
+          # @option options [string] :thread_ts
+          #   Timestamp of the thread root message the session is scoped to. Required for thread-based sessions in regular channels and DMs. Must be omitted for session channels.
+          # @see https://api.slack.com/methods/agents.sessions.rename
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/agents.sessions/agents.sessions.rename.json
+          def agents_sessions_rename(options = {})
+            raise ArgumentError, 'Required arguments :title missing' if options[:title].nil?
+            post('agents.sessions.rename', options)
+          end
+
+          #
+          # Set an agent session's lifecycle status, creating the session if needed.
+          #
+          # @option options [string] :channel_id
+          #   ID of the channel containing the agent session. Required for public channels.
+          # @option options [enum] :status
+          #   The lifecycle status to set.
+          # @option options [string] :thread_ts
+          #   Timestamp of the thread root message the session is scoped to. Required for thread-based sessions in regular channels and DMs. Must be omitted for session channels.
+          # @option options [string] :title
+          #   Title for the agent session (max 200 characters). Only used when creating a new session; ignored if the session already exists. To rename an existing session, use agents.sessions.rename.
+          # @option options [string] :initiator_user_id
+          #   The user who initiated the session. Only used when creating a new session; ignored if the session already exists. Must be a member of the channel.
+          # @option options [string] :icon_emoji
+          #   Emoji to use as the agent's icon. Takes priority over icon_url. Remains in effect until you clear it (pass null) or set a new value. Requires the chat:write.customize scope.
+          # @option options [string] :icon_url
+          #   URL to an image to use as the agent's icon. Remains in effect until you clear it (pass null) or set a new value. Requires the chat:write.customize scope.
+          # @option options [string] :username
+          #   Display name override for the agent (max 200 characters). Remains in effect until you clear it (pass null) or set a new value. Requires the chat:write.customize scope.
+          # @see https://api.slack.com/methods/agents.sessions.setStatus
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/agents.sessions/agents.sessions.setStatus.json
+          def agents_sessions_setStatus(options = {})
+            raise ArgumentError, 'Required arguments :status missing' if options[:status].nil?
+            post('agents.sessions.setStatus', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AppsManagedPermissions
+          #
+          # Set who can interact with a managed app. Lets the builder who created a managed app on a partner platform configure the app's permissions as themselves, using a user token from the manager app. Permissions can only be set before the app is installed: if the app is already installed, this method makes no change and returns the app's current permissions.
+          #
+          # @option options [Object] :app_id
+          #   Encoded ID of the managed app to configure.
+          # @option options [enum] :permissions
+          #   Who can interact with the app. Use everyone to allow all members, or app_owner to restrict access to the app's owner.
+          # @see https://api.slack.com/methods/apps.managed.permissions.set
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.managed.permissions/apps.managed.permissions.set.json
+          def apps_managed_permissions_set(options = {})
+            raise ArgumentError, 'Required arguments :app_id missing' if options[:app_id].nil?
+            raise ArgumentError, 'Required arguments :permissions missing' if options[:permissions].nil?
+            post('apps.managed.permissions.set', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -38,7 +38,7 @@ module Slack
           # @option options [Object] :channel_id
           #   Channel ID containing the assistant thread.
           # @option options [string] :thread_ts
-          #   Message timestamp of the thread to set suggested prompts for.
+          #   Message timestamp of the thread to set suggested prompts for. If not provided, the prompts will be set for the latest message in the channel.
           # @option options [Object] :prompts
           #   Each prompt should be supplied with its title and message attribute.
           # @option options [string] :title

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

@@ -12,7 +12,7 @@ module Slack
           # @option options [string] :title
           #   Title of the newly created canvas.
           # @option options [Object] :document_content
-          #   Structure describing the type and value of the content to create.
+          #   Structure describing the type and value of the content to create. The markdown content is limited to 1 MiB (1,048,576 characters).
           # @option options [string] :channel_id
           #   Channel ID of the channel the canvas will be tabbed in. This is a required field for free teams.
           # @see https://api.slack.com/methods/canvases.create
@@ -39,7 +39,7 @@ module Slack
           # @option options [Object] :canvas_id
           #   Encoded ID of the canvas.
           # @option options [array] :changes
-          #   List of changes to apply on the specified canvas.
+          #   List of changes to apply on the specified canvas. The markdown content of each change is limited to 1 MiB (1,048,576 characters).
           # @see https://api.slack.com/methods/canvases.edit
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/canvases/canvases.edit.json
           def canvases_edit(options = {})
@@ -47,6 +47,20 @@ module Slack
             raise ArgumentError, 'Required arguments :changes missing' if options[:changes].nil?
             post('canvases.edit', options)
           end
+
+          #
+          # Get the content of a canvas as markdown (default) or HTML.
+          #
+          # @option options [Object] :canvas_id
+          #   Encoded ID of the canvas.
+          # @option options [enum] :content_type
+          #   Format in which to return the canvas content. Defaults to markdown.
+          # @see https://api.slack.com/methods/canvases.getContent
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/canvases/canvases.getContent.json
+          def canvases_getContent(options = {})
+            raise ArgumentError, 'Required arguments :canvas_id missing' if options[:canvas_id].nil?
+            post('canvases.getContent', options)
+          end
         end
       end
     end

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

@@ -22,7 +22,6 @@ module Slack
           def chat_appendStream(options = {})
             raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             raise ArgumentError, 'Required arguments :ts missing' if options[:ts].nil?
-            raise ArgumentError, 'Required arguments :markdown_text missing' if options[:markdown_text].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('chat.appendStream', options)
           end
@@ -131,6 +130,8 @@ module Slack
           #   Find and link channel names and usernames.
           # @option options [string] :markdown_text
           #   Accepts message text formatted in markdown. This argument should not be used in conjunction with blocks or text. Limit this field to 12,000 characters.
+          # @option options [string] :metadata
+          #   JSON object with an entities array of work object entity metadata, presented as a URL-encoded string. Only entity metadata is supported: ephemeral messages are not persisted and never dispatch message_metadata_* events, so event_type/event_payload message metadata is ignored here. Each entity requires entity_type, entity_payload, external_ref, and url.
           # @option options [string] :parse
           #   Change how messages are treated. Defaults to none. See below.
           # @option options [string] :text
@@ -149,7 +150,7 @@ module Slack
             raise ArgumentError, 'At least one of :attachments, :blocks, :text, :markdown_text is required' if options[:attachments].nil? && options[:blocks].nil? && options[:text].nil? && options[:markdown_text].nil?
             raise ArgumentError, ':text, :markdown_text are mutually exclusive' if !options[:text].nil? && !options[:markdown_text].nil?
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
-            options = encode_options_as_json(options, %i[attachments blocks])
+            options = encode_options_as_json(options, %i[attachments blocks metadata])
             post('chat.postEphemeral', options)
           end
 
@@ -192,6 +193,8 @@ module Slack
           #   Pass false to disable unfurling of media content.
           # @option options [string] :username
           #   Set your bot's user name.
+          # @option options [boolean] :unfurl_app_links
+          #   Pass true to unfurl links from installed apps, or false to prevent app links from unfurling. When omitted, app links follow the unfurl_links setting.
           # @see https://api.slack.com/methods/chat.postMessage
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postMessage.json
           def chat_postMessage(options = {})
@@ -248,19 +251,19 @@ module Slack
           # Starts a new streaming conversation.
           #
           # @option options [channel] :channel
-          #   An encoded ID that represents a channel thread or DM.
+          #   An encoded ID that represents a channel, thread, or DM.
           # @option options [array] :chunks
-          #   Array of streaming chunks.
+          #   Array of streaming chunks. Can include markdown text chunk objects, task update chunk objects, plan update chunks, or blocks chunks.
           # @option options [string] :markdown_text
           #   Accepts message text formatted in markdown. Limit this field to 12,000 characters.
           # @option options [string] :thread_ts
-          #   Provide another message's ts value to reply to. Streamed messages should always be replies to a user request.
+          #   Provide another message's ts value to reply to. Omit it to stream a top-level message instead of a thread reply; this is only supported in channels where the whole channel is one session, such as Slack Code, and returns invalid_thread_ts elsewhere. Passing "0" is equivalent to omitting it.
           # @option options [Object] :recipient_user_id
           #   The encoded ID of the user to receive the streaming text. Required when streaming to channels.
           # @option options [string] :recipient_team_id
           #   The encoded ID of the team the user receiving the streaming text belongs to. Required when streaming to channels.
           # @option options [enum] :task_display_mode
-          #   Specifies how tasks are displayed in the message. A timeline displays individual tasks with text in sequential order, plan displays all tasks together, with the first tasks's placement determining the placement of the rest of the tasks, and dense collapses consecutive tool calls into a single summarized task card.
+          #   Specifies how tasks are displayed in the message. timeline task updates render as individual task cards interleaved with streamed text. plan task updates render together in a plan block.
           # @option options [string] :icon_emoji
           #   Emoji to use as the icon for this message. Overrides icon_url.
           # @option options [string] :icon_url
@@ -271,7 +274,6 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.startStream.json
           def chat_startStream(options = {})
             raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
-            raise ArgumentError, 'Required arguments :thread_ts missing' if options[:thread_ts].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('chat.startStream', options)
           end
@@ -282,7 +284,7 @@ module Slack
           # @option options [channel] :channel
           #   An encoded ID that represents a channel, private group, or DM.
           # @option options [array] :chunks
-          #   Array of streaming chunks.
+          #   Array of streaming chunks. Can include markdown text chunk objects, task update chunk objects, plan update chunks, or blocks chunks.
           # @option options [timestamp] :ts
           #   The timestamp of the streaming message.
           # @option options [string] :markdown_text
@@ -291,6 +293,8 @@ module Slack
           #   A list of blocks that will be rendered at the bottom of the finalized message.
           # @option options [string] :metadata
           #   JSON object with event_type and event_payload fields, presented as a URL-encoded string. Metadata you post to Slack is accessible to any app or user who is a member of that workspace.
+          # @option options [enum] :session_status
+          #   The session status to set after stopping the stream.
           # @see https://api.slack.com/methods/chat.stopStream
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.stopStream.json
           def chat_stopStream(options = {})
@@ -309,7 +313,7 @@ module Slack
           # @option options [timestamp] :ts
           #   Timestamp of the message to add unfurl behavior to. Required for public channels.
           # @option options [string] :unfurls
-          #   URL-encoded JSON map with keys set to URLs featured in the the message, pointing to their unfurl blocks or message attachments. Required for public channels.
+          #   URL-encoded JSON map with keys set to URLs featured in the message, pointing to their unfurl blocks or message attachments. Required for public channels.
           # @option options [string] :user_auth_message
           #   Provide a simply-formatted string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior. Provides two buttons, Not now or Never ask me again.
           # @option options [boolean] :user_auth_required

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

@@ -154,7 +154,7 @@ module Slack
           # @option options [boolean] :force
           #   When set to true and multiple user IDs are provided, continue inviting the valid ones while disregarding invalid IDs. Defaults to false.
           # @option options [string] :users
-          #   A comma separated list of user IDs. Up to 100 users may be listed.
+          #   A comma separated list of user IDs. Up to 1000 users may be listed.
           # @see https://api.slack.com/methods/conversations.invite
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.invite.json
           def conversations_invite(options = {})

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

@@ -12,7 +12,7 @@ module Slack
           # @option options [string] :channel_id
           #   Channel ID of the channel the canvas will be tabbed in.
           # @option options [Object] :document_content
-          #   Structure describing the type and value of the content to create.
+          #   Structure describing the type and value of the content to create. The markdown content is limited to 1 MiB (1,048,576 characters).
           # @option options [string] :title
           #   Title of the newly created canvas.
           # @see https://api.slack.com/methods/conversations.canvases.create

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

@@ -6,6 +6,54 @@ module Slack
     module Api
       module Endpoints
         module Entity
+          #
+          # Acknowledge a comment mutation (edit, delete, or post) on a work object entity. Apps call this endpoint to confirm they have processed a comment action, and the backend emits a dedicated RTM event to the user.
+          #
+          # @option options [string] :trigger_id
+          #   A reference to the original user action that initiated the comment mutation.
+          # @option options [object] :comment
+          #   The full comment data. Required for edit and post actions. See the comment schema for the full list of properties.
+          # @option options [string] :error
+          #   Error message if the action failed in the app. When present, signals that the mutation could not be completed.
+          # @see https://api.slack.com/methods/entity.acknowledgeCommentAction
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/entity/entity.acknowledgeCommentAction.json
+          def entity_acknowledgeCommentAction(options = {})
+            raise ArgumentError, 'Required arguments :trigger_id missing' if options[:trigger_id].nil?
+            post('entity.acknowledgeCommentAction', options)
+          end
+
+          #
+          # Provide comments for work objects. Apps call this endpoint to send per-user flexpane comment data to the client.
+          #
+          # @option options [array] :comments
+          #   Array of comments to present to the user. See the comment schema for the full list of properties.
+          # @option options [string] :cursor
+          #   App supplied cursor used for pagination, will be sent in the next request for comments.
+          # @option options [boolean] :can_post_comment
+          #   Indicates whether the user has permissions to post comments.
+          # @option options [string] :trigger_id
+          #   A reference to the original user action that initiated the request.
+          # @option options [string] :delete_action_id
+          #   The block action id that will be sent when a delete request is initiated for a comment.
+          # @option options [boolean] :user_auth_required
+          #   Set to true (or 1) to indicate that the user must authenticate to see the comments data.
+          # @option options [string] :user_auth_url
+          #   A custom URL to which users are directed for authentication if required.
+          # @option options [Object] :error
+          # @see https://api.slack.com/methods/entity.presentComments
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/entity/entity.presentComments.json
+          def entity_presentComments(options = {})
+            raise ArgumentError, 'Required arguments :comments missing' if options[:comments].nil?
+            raise ArgumentError, 'Required arguments :trigger_id missing' if options[:trigger_id].nil?
+            if block_given?
+              Pagination::Cursor.new(self, :entity_presentComments, options).each do |page|
+                yield page
+              end
+            else
+              post('entity.presentComments', options)
+            end
+          end
+
           #
           # Provide custom flexpane behavior for Work Objects. Apps call this endpoint to send per-user flexpane metadata to the client.
           #

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

@@ -21,6 +21,12 @@ module Slack
           #   The message text introducing the file in specified channels.
           # @option options [string] :blocks
           #   A JSON-based array of structured rich text blocks, presented as a URL-encoded string. If the initial_comment field is provided, the blocks field is ignored.
+          # @option options [string] :username
+          #   Set your bot's user name for the file share message. Requires the chat:write.customize scope.
+          # @option options [string] :icon_url
+          #   URL to an image to use as the icon for the file share message. Requires the chat:write.customize scope.
+          # @option options [string] :icon_emoji
+          #   Emoji to use as the icon for the file share message. Overrides icon_url. Requires the chat:write.customize scope.
           # @see https://api.slack.com/methods/files.completeUploadExternal
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.completeUploadExternal.json
           def files_completeUploadExternal(options = {})
@@ -186,6 +192,7 @@ module Slack
           # @see https://api.slack.com/methods/files.upload
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.upload.json
           def files_upload(options = {})
+            options = options.merge(filename: 'file') if options[:file] && !options[:filename]
             post('files.upload', options)
           end
         end

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

@@ -31,6 +31,39 @@ module Slack
             post('oauth.v2.access', options)
           end
 
+          #
+          # Call this to rotate the secret on an old API token with a short secret. Must be paired with a call to oauth.v2.completeShortTokenRotation to confirm the change.
+          #
+          # @option options [string] :client_id
+          #   Issued when you created your application. Must be the app the token being rotated was issued to.
+          # @option options [string] :client_secret
+          #   Issued when you created your application.
+          # @see https://api.slack.com/methods/oauth.v2.beginShortTokenRotation
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/oauth.v2/oauth.v2.beginShortTokenRotation.json
+          def oauth_v2_beginShortTokenRotation(options = {})
+            raise ArgumentError, 'Required arguments :client_id missing' if options[:client_id].nil?
+            raise ArgumentError, 'Required arguments :client_secret missing' if options[:client_secret].nil?
+            post('oauth.v2.beginShortTokenRotation', options)
+          end
+
+          #
+          # Call this to finish rotating the secret on an old API token with a short secret. Must be paired with a call to oauth.v2.beginShortTokenRotation to start the process.
+          #
+          # @option options [string] :client_id
+          #   Issued when you created your application. Must be the app the token being rotated was issued to.
+          # @option options [string] :client_secret
+          #   Issued when you created your application.
+          # @option options [string] :new_token
+          #   The new xoxp token returned by oauth.v2.beginShortTokenRotation.
+          # @see https://api.slack.com/methods/oauth.v2.completeShortTokenRotation
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/oauth.v2/oauth.v2.completeShortTokenRotation.json
+          def oauth_v2_completeShortTokenRotation(options = {})
+            raise ArgumentError, 'Required arguments :client_id missing' if options[:client_id].nil?
+            raise ArgumentError, 'Required arguments :client_secret missing' if options[:client_secret].nil?
+            raise ArgumentError, 'Required arguments :new_token missing' if options[:new_token].nil?
+            post('oauth.v2.completeShortTokenRotation', options)
+          end
+
           #
           # Exchanges a legacy access token for a new expiring access token and refresh token
           #