slack-ruby-client 3.1.0 → 3.3.0

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

@@ -14,9 +14,15 @@ module Slack
           # @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...'.
+          #   Status of the specified bot user, e.g., 'is thinking...'. A two minute timeout applies, which will cause the status to be removed if no message has been sent.
           # @option options [array] :loading_messages
-          #   The list of messages to rotate through as a loading indicator.
+          #   The list of messages to rotate through as a loading indicator. Maximum of 10 messages.
+          # @option options [string] :icon_emoji
+          #   Emoji to use as the icon for this message. Overrides icon_url.
+          # @option options [string] :icon_url
+          #   Image URL to use as the icon for this message.
+          # @option options [string] :username
+          #   The bot's username to display.
           # @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 = {})
@@ -32,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
@@ -41,7 +47,6 @@ module Slack
           # @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 :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/blocks.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module Blocks
+          #
+          # Validates blocks, messages, and views Block Kit JSON payloads.
+          #
+          # @option options [string] :blocks
+          #   A JSON-encoded array of structured blocks. Provide exactly one of blocks, view, or message.
+          # @option options [string] :message
+          #   A JSON-encoded message payload to validate. Provide exactly one of blocks, view, or message.
+          # @option options [string] :view
+          #   A JSON-encoded view payload to validate. Provide exactly one of blocks, view, or message.
+          # @see https://api.slack.com/methods/blocks.validate
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/blocks/blocks.validate.json
+          def blocks_validate(options = {})
+            options = encode_options_as_json(options, %i[blocks message view])
+            post('blocks.validate', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -10,7 +10,7 @@ module Slack
           # Add bookmark to a channel.
           #
           # @option options [string] :channel_id
-          #   Channel to add bookmark in.
+          #   Channel to add bookmark in. Required for public channels.
           # @option options [string] :title
           #   Title for the bookmark.
           # @option options [string] :link
@@ -28,7 +28,6 @@ module Slack
           # @see https://api.slack.com/methods/bookmarks.add
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/bookmarks/bookmarks.add.json
           def bookmarks_add(options = {})
-            raise ArgumentError, 'Required arguments :channel_id missing' if options[:channel_id].nil?
             raise ArgumentError, 'Required arguments :title missing' if options[:title].nil?
             raise ArgumentError, 'Required arguments :type missing' if options[:type].nil?
             post('bookmarks.add', options)
@@ -38,9 +37,9 @@ module Slack
           # Edit bookmark.
           #
           # @option options [string] :channel_id
-          #   Channel to update bookmark in.
+          #   Channel to update bookmark in. Required for public channels.
           # @option options [string] :bookmark_id
-          #   Bookmark to update.
+          #   Bookmark to update. Required for public channels.
           # @option options [string] :title
           #   Title for the bookmark.
           # @option options [string] :link
@@ -50,8 +49,6 @@ module Slack
           # @see https://api.slack.com/methods/bookmarks.edit
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/bookmarks/bookmarks.edit.json
           def bookmarks_edit(options = {})
-            raise ArgumentError, 'Required arguments :channel_id missing' if options[:channel_id].nil?
-            raise ArgumentError, 'Required arguments :bookmark_id missing' if options[:bookmark_id].nil?
             post('bookmarks.edit', options)
           end
 
@@ -59,11 +56,10 @@ module Slack
           # List bookmark for the channel.
           #
           # @option options [string] :channel_id
-          #   Channel to list bookmarks in.
+          #   Channel to list bookmarks in. Required for public channels.
           # @see https://api.slack.com/methods/bookmarks.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/bookmarks/bookmarks.list.json
           def bookmarks_list(options = {})
-            raise ArgumentError, 'Required arguments :channel_id missing' if options[:channel_id].nil?
             post('bookmarks.list', options)
           end
 
@@ -71,16 +67,14 @@ module Slack
           # Remove bookmark from the channel.
           #
           # @option options [string] :channel_id
-          #   Channel to remove bookmark.
+          #   Channel to remove bookmark. Required for public channels.
           # @option options [string] :bookmark_id
-          #   Bookmark to remove.
+          #   Bookmark to remove. Required for public channels.
           # @option options [string] :quip_section_id
           #   Quip section ID to unbookmark.
           # @see https://api.slack.com/methods/bookmarks.remove
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/bookmarks/bookmarks.remove.json
           def bookmarks_remove(options = {})
-            raise ArgumentError, 'Required arguments :channel_id missing' if options[:channel_id].nil?
-            raise ArgumentError, 'Required arguments :bookmark_id missing' if options[:bookmark_id].nil?
             post('bookmarks.remove', options)
           end
         end

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

@@ -11,6 +11,8 @@ 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.
           # @option options [timestamp] :ts
           #   The timestamp of the streaming message.
           # @option options [string] :markdown_text
@@ -20,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
@@ -129,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
@@ -144,9 +147,10 @@ module Slack
           def chat_postEphemeral(options = {})
             raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             raise ArgumentError, 'Required arguments :user missing' if options[:user].nil?
-            raise ArgumentError, 'At least one of :attachments, :blocks, :text is required' if options[:attachments].nil? && options[:blocks].nil? && options[:text].nil?
+            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
 
@@ -172,7 +176,7 @@ module Slack
           # @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 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.
+          #   JSON object with event_type and event_payload fields, presented as a URL-encoded string. You can also provide Work Object entity metadata using this parameter. Metadata you post to Slack is accessible to any app or user who is a member of that workspace.
           # @option options [boolean] :mrkdwn
           #   Disable Slack markup parsing by setting to false. Enabled by default.
           # @option options [string] :parse
@@ -189,11 +193,14 @@ 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 = {})
             raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
-            raise ArgumentError, 'At least one of :attachments, :blocks, :text is required' if options[:attachments].nil? && options[:blocks].nil? && options[:text].nil?
+            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 = encode_options_as_json(options, %i[attachments blocks metadata])
             post('chat.postMessage', options)
           end
@@ -234,7 +241,8 @@ module Slack
           def chat_scheduleMessage(options = {})
             raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             raise ArgumentError, 'Required arguments :post_at missing' if options[:post_at].nil?
-            raise ArgumentError, 'At least one of :attachments, :blocks, :text is required' if options[:attachments].nil? && options[:blocks].nil? && options[:text].nil?
+            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 = encode_options_as_json(options, %i[attachments blocks metadata])
             post('chat.scheduleMessage', options)
           end
@@ -243,20 +251,29 @@ module Slack
           # Starts a new streaming conversation.
           #
           # @option options [channel] :channel
-          #   An encoded ID that represents a channel, private group, or DM.
+          #   An encoded ID that represents a channel, thread, or DM.
+          # @option options [array] :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. 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
+          #   Image URL to use as the icon for this message.
+          # @option options [string] :username
+          #   The bot's username to display.
           # @see https://api.slack.com/methods/chat.startStream
           # @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
@@ -266,6 +283,8 @@ 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. 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
@@ -274,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 = {})
@@ -288,11 +309,11 @@ module Slack
           # Provide custom unfurl behavior for user-posted URLs
           #
           # @option options [channel] :channel
-          #   Channel ID of the message. Both channel and ts must be provided together, or unfurl_id and source must be provided together.
+          #   Channel ID of the message. Both channel and ts must be provided together, or unfurl_id and source must be provided together. Required for public channels.
           # @option options [timestamp] :ts
-          #   Timestamp of the message to add unfurl behavior to.
+          #   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. Either unfurls or metadata must be provided.
+          #   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
@@ -305,13 +326,11 @@ module Slack
           #   The ID of the link to unfurl. Both unfurl_id and source must be provided together, or channel and ts must be provided together.
           # @option options [enum] :source
           #   The source of the link to unfurl. The source may either be composer, when the link is inside the message composer, or conversations_history, when the link has been posted to a conversation.
-          # @option options [string] :metadata
-          #   JSON object with entity_type and entity_payload fields, presented as a URL-encoded string. Either unfurls or metadata must be provided.
           # @see https://api.slack.com/methods/chat.unfurl
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.unfurl.json
           def chat_unfurl(options = {})
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
-            options = encode_options_as_json(options, %i[unfurls user_auth_blocks metadata])
+            options = encode_options_as_json(options, %i[unfurls user_auth_blocks])
             post('chat.unfurl', options)
           end
 
@@ -322,6 +341,8 @@ module Slack
           #   Pass true to update the message as the authed user. Bot users in this context are considered authed users.
           # @option options [string] :attachments
           #   A JSON-based array of structured attachments, presented as a URL-encoded string.
+          # @option options [string] :unfurled_attachments
+          #   A JSON-based array of structured attachments, presented as a URL-encoded string.
           # @option options [string] :blocks
           #   A JSON-based array of structured blocks, presented as a URL-encoded string.
           # @option options [string] :markdown_text
@@ -347,9 +368,10 @@ module Slack
           def chat_update(options = {})
             raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             raise ArgumentError, 'Required arguments :ts missing' if options[:ts].nil?
-            raise ArgumentError, 'At least one of :attachments, :blocks, :text is required' if options[:attachments].nil? && options[:blocks].nil? && options[:text].nil?
+            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(channel: conversations_id(options)['channel']['id']) if options[:channel]
-            options = encode_options_as_json(options, %i[attachments blocks metadata])
+            options = encode_options_as_json(options, %i[attachments unfurled_attachments blocks metadata])
             post('chat.update', options)
           end
         end

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

@@ -34,7 +34,7 @@ module Slack
           # @option options [Object] :invite_id
           #   ID of the shared channel invite to approve.
           # @option options [Object] :target_team
-          #   The team or enterprise id of the other party involved in the invitation you are approving.
+          #   The team or enterprise ID of the receiving party involved in the invitation you are approving.
           # @see https://api.slack.com/methods/conversations.approveSharedInvite
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.approveSharedInvite.json
           def conversations_approveSharedInvite(options = {})
@@ -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 = {})
@@ -100,7 +106,7 @@ module Slack
           end
 
           #
-          # List for a team, in a channel, or from a user with applied filters.
+          # List files for a team, in a channel, or from a user with applied filters.
           #
           # @option options [channel] :channel
           #   Filter files appearing in a specific channel, indicated by its ID.
@@ -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

@@ -23,12 +23,47 @@ module Slack
           #   The grant_type param as described in the OAuth spec.
           # @option options [string] :refresh_token
           #   The refresh_token param as described in the OAuth spec.
+          # @option options [string] :assertion
+          #   Identity assertion JWT authorization grant.
           # @see https://api.slack.com/methods/oauth.v2.access
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/oauth.v2/oauth.v2.access.json
           def oauth_v2_access(options = {})
             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
           #

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

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module OauthV2User
+          #
+          # Exchanges a temporary OAuth verifier code for a user access token.
+          #
+          # @option options [string] :client_id
+          #   Issued when you created your application. If possible, avoid sending client_id and client_secret as parameters in your request and instead supply the Client ID and Client Secret using the HTTP Basic authentication scheme.
+          # @option options [string] :client_secret
+          #   Issued when you created your application. If possible, avoid sending client_id and client_secret as parameters in your request and instead supply the Client ID and Client Secret using the HTTP Basic authentication scheme.
+          # @option options [string] :code
+          #   The code param returned via the OAuth callback.
+          # @option options [string] :code_verifier
+          #   The code_verifier param used to generate the code_challenge originally. Used for PKCE.
+          # @option options [string] :redirect_uri
+          #   This must match the originally submitted URI (if one was sent).
+          # @option options [string] :grant_type
+          #   The grant_type param as described in the OAuth spec.
+          # @option options [string] :refresh_token
+          #   The refresh_token param as described in the OAuth spec.
+          # @option options [string] :assertion
+          #   Identity assertion JWT authorization grant.
+          # @see https://api.slack.com/methods/oauth.v2.user.access
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/oauth.v2.user/oauth.v2.user.access.json
+          def oauth_v2_user_access(options = {})
+            post('oauth.v2.user.access', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -21,6 +21,8 @@ module Slack
           #   The grant_type param as described in the OAuth spec.
           # @option options [string] :refresh_token
           #   The refresh_token param as described in the OAuth spec.
+          # @option options [string] :code_verifier
+          #   PKCE code verifier (RFC 7636). Required when the authorization request included a code_challenge.
           # @see https://api.slack.com/methods/openid.connect.token
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/openid.connect/openid.connect.token.json
           def openid_connect_token(options = {})

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

@@ -13,6 +13,12 @@ module Slack
           #   ID of the List to export.
           # @option options [string] :job_id
           #   The ID of the recently started job to export the List.
+          # @option options [Object] :format
+          #   Format the export was started with. Must match the format passed to slackLists.download.start. Defaults to csv.
+          # @option options [boolean] :include_threads
+          #   Must match the include_threads passed to slackLists.download.start. The returned download_url carries this through so the served export matches what was generated. Only applies when format is json.
+          # @option options [boolean] :include_attachments
+          #   Must match the include_attachments passed to slackLists.download.start. The returned download_url carries this through so the served export matches what was generated. Only applies when format is json.
           # @see https://api.slack.com/methods/slackLists.download.get
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/slackLists.download/slackLists.download.get.json
           def slackLists_download_get(options = {})
@@ -27,6 +33,12 @@ module Slack
           # @option options [string] :list_id
           #   ID of the List to export.
           # @option options [boolean] :include_archived
+          # @option options [Object] :format
+          #   Format of the export. Defaults to csv for backward compatibility. Use json for a complete, hierarchical export.
+          # @option options [boolean] :include_threads
+          #   Include each item's conversation thread in the export. Only applies when format is json.
+          # @option options [boolean] :include_attachments
+          #   Include file attachment metadata and access paths in the export. Only applies when format is json.
           # @see https://api.slack.com/methods/slackLists.download.start
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/slackLists.download/slackLists.download.start.json
           def slackLists_download_start(options = {})

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

@@ -82,6 +82,8 @@ module Slack
           #   Next cursor for pagination.
           # @option options [boolean] :archived
           #   Boolean indicating whether archived items or normal items should be returned.
+          # @option options [boolean] :include_list
+          #   Set to true to also return the parent list object, including its title, column schema, and total row count. Defaults to false to keep the response small.
           # @see https://api.slack.com/methods/slackLists.items.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/slackLists.items/slackLists.items.list.json
           def slackLists_items_list(options = {})

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

@@ -7,12 +7,14 @@ module Slack
       module Endpoints
         module Users
           #
-          # List conversations the calling user may access.
+          # List conversations the calling user is a member of.
           #
           # @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. Default value fetches the first "page" of the collection. See pagination for more detail.
           # @option options [boolean] :exclude_archived
           #   Set to true to exclude archived channels from the list.
+          # @option options [boolean] :exclude_muted
+          #   Set to true to exclude muted channels from the list.
           # @option options [number] :limit
           #   The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached. Must be an integer with a max value of 999.
           # @option options [string] :team_id
@@ -74,7 +76,6 @@ module Slack
           # @see https://api.slack.com/methods/users.info
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/users/users.info.json
           def users_info(options = {})
-            raise ArgumentError, 'Required arguments :user missing' if options[:user].nil?
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             post('users.info', options)
           end

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

@@ -33,6 +33,7 @@ module Slack
           #   A view payload. This must be a JSON-encoded string.
           # @option options [string] :hash
           #   A string that represents view state to protect against possible race conditions.
+          # @option options [string] :interactivity_pointer
           # @see https://api.slack.com/methods/views.publish
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/views/views.publish.json
           def views_publish(options = {})