slack-ruby-client 3.1.0 → 3.3.0

data/bin/commands/bookmarks.rb

@@ -9,7 +9,7 @@ module Slack
         g.desc 'Add bookmark to a channel.'
         g.long_desc %( Add bookmark to a channel. )
         g.command 'add' do |c|
-          c.flag 'channel_id', desc: 'Channel to add bookmark in.'
+          c.flag 'channel_id', desc: 'Channel to add bookmark in. Required for public channels.'
           c.flag 'title', desc: 'Title for the bookmark.'
           c.flag 'link', desc: 'Link to bookmark.'
           c.flag 'type', desc: 'Type of the bookmark i.e link.'
@@ -25,8 +25,8 @@ module Slack
         g.desc 'Edit bookmark.'
         g.long_desc %( Edit bookmark. )
         g.command 'edit' do |c|
-          c.flag 'channel_id', desc: 'Channel to update bookmark in.'
-          c.flag 'bookmark_id', desc: 'Bookmark to update.'
+          c.flag 'channel_id', desc: 'Channel to update bookmark in. Required for public channels.'
+          c.flag 'bookmark_id', desc: 'Bookmark to update. Required for public channels.'
           c.flag 'title', desc: 'Title for the bookmark.'
           c.flag 'link', desc: 'Link to bookmark.'
           c.flag 'emoji', desc: 'Emoji tag to apply to the link.'
@@ -38,7 +38,7 @@ module Slack
         g.desc 'List bookmark for the channel.'
         g.long_desc %( List bookmark for the channel. )
         g.command 'list' do |c|
-          c.flag 'channel_id', desc: 'Channel to list bookmarks in.'
+          c.flag 'channel_id', desc: 'Channel to list bookmarks in. Required for public channels.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.bookmarks_list(options))
           end
@@ -47,8 +47,8 @@ module Slack
         g.desc 'Remove bookmark from the channel.'
         g.long_desc %( Remove bookmark from the channel. )
         g.command 'remove' do |c|
-          c.flag 'channel_id', desc: 'Channel to remove bookmark.'
-          c.flag 'bookmark_id', desc: 'Bookmark to remove.'
+          c.flag 'channel_id', desc: 'Channel to remove bookmark. Required for public channels.'
+          c.flag 'bookmark_id', desc: 'Bookmark to remove. Required for public channels.'
           c.flag 'quip_section_id', desc: 'Quip section ID to unbookmark.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.bookmarks_remove(options))

data/bin/commands/canvases.rb

@@ -10,7 +10,7 @@ module Slack
         g.long_desc %( Create canvas for a user )
         g.command 'create' do |c|
           c.flag 'title', desc: 'Title of the newly created canvas.'
-          c.flag 'document_content', desc: 'Structure describing the type and value of the content to create.'
+          c.flag 'document_content', desc: 'Structure describing the type and value of the content to create. The markdown content is limited to 1 MiB (1,048,576 characters).'
           c.flag 'channel_id', desc: 'Channel ID of the channel the canvas will be tabbed in. This is a required field for free teams.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.canvases_create(options))
@@ -30,11 +30,21 @@ module Slack
         g.long_desc %( Update an existing canvas )
         g.command 'edit' do |c|
           c.flag 'canvas_id', desc: 'Encoded ID of the canvas.'
-          c.flag 'changes', desc: 'List of changes to apply on the specified canvas.'
+          c.flag 'changes', desc: 'List of changes to apply on the specified canvas. The markdown content of each change is limited to 1 MiB (1,048,576 characters).'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.canvases_edit(options))
           end
         end
+
+        g.desc 'Get the content of a canvas as markdown (default) or HTML.'
+        g.long_desc %( Get the content of a canvas as markdown (default) or HTML. )
+        g.command 'getContent' do |c|
+          c.flag 'canvas_id', desc: 'Encoded ID of the canvas.'
+          c.flag 'content_type', desc: 'Format in which to return the canvas content. Defaults to markdown.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.canvases_getContent(options))
+          end
+        end
       end
     end
   end

data/bin/commands/chat.rb

@@ -10,6 +10,7 @@ module Slack
         g.long_desc %( Appends text to an existing streaming conversation. )
         g.command 'appendStream' do |c|
           c.flag 'channel', desc: 'An encoded ID that represents a channel, private group, or DM.'
+          c.flag 'chunks', desc: 'Array of streaming chunks.'
           c.flag 'ts', desc: 'The timestamp of the streaming message.'
           c.flag 'markdown_text', desc: 'Accepts message text formatted in markdown. Limit this field to 12,000 characters. This text is what will be appended to the message received so far.'
           c.action do |_global_options, options, _args|
@@ -81,6 +82,7 @@ module Slack
           c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message.'
           c.flag 'link_names', desc: 'Find and link channel names and usernames.'
           c.flag 'markdown_text', desc: '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.'
+          c.flag 'metadata', desc: '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.'
           c.flag 'parse', desc: 'Change how messages are treated. Defaults to none. See below.'
           c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
           c.flag 'thread_ts', desc: "Provide another message's ts value to post this message in a thread. Avoid using a reply's ts value; use its parent's value instead. Ephemeral messages in threads are only shown if there is already an active thread."
@@ -103,7 +105,7 @@ module Slack
           c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message.'
           c.flag 'link_names', desc: 'Find and link user groups. No longer supports linking individual users; use syntax shown in Mentioning Users instead.'
           c.flag 'markdown_text', desc: '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.'
-          c.flag 'metadata', desc: '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.'
+          c.flag 'metadata', desc: '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.'
           c.flag 'mrkdwn', desc: 'Disable Slack markup parsing by setting to false. Enabled by default.'
           c.flag 'parse', desc: 'Change how messages are treated. See below.'
           c.flag 'reply_broadcast', desc: 'Used in conjunction with thread_ts and indicates whether reply should be made visible to everyone in the channel or conversation. Defaults to false.'
@@ -112,6 +114,7 @@ module Slack
           c.flag 'unfurl_links', desc: 'Pass true to enable unfurling of primarily text-based content.'
           c.flag 'unfurl_media', desc: 'Pass false to disable unfurling of media content.'
           c.flag 'username', desc: "Set your bot's user name."
+          c.flag 'unfurl_app_links', desc: '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.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.chat_postMessage(options))
           end
@@ -142,11 +145,16 @@ module Slack
         g.desc 'Starts a new streaming conversation.'
         g.long_desc %( Starts a new streaming conversation. )
         g.command 'startStream' do |c|
-          c.flag 'channel', desc: 'An encoded ID that represents a channel, private group, or DM.'
+          c.flag 'channel', desc: 'An encoded ID that represents a channel, thread, or DM.'
+          c.flag 'chunks', desc: 'Array of streaming chunks. Can include markdown text chunk objects, task update chunk objects, plan update chunks, or blocks chunks.'
           c.flag 'markdown_text', desc: 'Accepts message text formatted in markdown. Limit this field to 12,000 characters.'
-          c.flag 'thread_ts', desc: "Provide another message's ts value to reply to. Streamed messages should always be replies to a user request."
+          c.flag 'thread_ts', desc: "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."
           c.flag 'recipient_user_id', desc: 'The encoded ID of the user to receive the streaming text. Required when streaming to channels.'
           c.flag 'recipient_team_id', desc: 'The encoded ID of the team the user receiving the streaming text belongs to. Required when streaming to channels.'
+          c.flag 'task_display_mode', desc: '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.'
+          c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url.'
+          c.flag 'icon_url', desc: 'Image URL to use as the icon for this message.'
+          c.flag 'username', desc: "The bot's username to display."
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.chat_startStream(options))
           end
@@ -156,10 +164,12 @@ module Slack
         g.long_desc %( Stops a streaming conversation. )
         g.command 'stopStream' do |c|
           c.flag 'channel', desc: 'An encoded ID that represents a channel, private group, or DM.'
+          c.flag 'chunks', desc: 'Array of streaming chunks. Can include markdown text chunk objects, task update chunk objects, plan update chunks, or blocks chunks.'
           c.flag 'ts', desc: 'The timestamp of the streaming message.'
           c.flag 'markdown_text', desc: 'Accepts message text formatted in markdown. Limit this field to 12,000 characters.'
           c.flag 'blocks', desc: 'A list of blocks that will be rendered at the bottom of the finalized message.'
           c.flag 'metadata', desc: '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.'
+          c.flag 'session_status', desc: 'The session status to set after stopping the stream.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.chat_stopStream(options))
           end
@@ -168,16 +178,15 @@ module Slack
         g.desc 'Provide custom unfurl behavior for user-posted URLs'
         g.long_desc %( Provide custom unfurl behavior for user-posted URLs )
         g.command 'unfurl' do |c|
-          c.flag 'channel', desc: 'Channel ID of the message. Both channel and ts must be provided together, or unfurl_id and source must be provided together.'
-          c.flag 'ts', desc: 'Timestamp of the message to add unfurl behavior to.'
-          c.flag 'unfurls', desc: '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.'
+          c.flag 'channel', desc: '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.'
+          c.flag 'ts', desc: 'Timestamp of the message to add unfurl behavior to. Required for public channels.'
+          c.flag 'unfurls', desc: '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.'
           c.flag 'user_auth_message', desc: '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.'
           c.flag 'user_auth_required', desc: 'Set to true or 1 to indicate the user must install your Slack app to trigger unfurls for this domain.'
           c.flag 'user_auth_url', desc: 'Send users to this custom URL where they will complete authentication in your app to fully trigger unfurling. Value should be properly URL-encoded.'
           c.flag 'user_auth_blocks', desc: 'Provide a JSON based array of structured blocks presented as URL-encoded string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior.'
           c.flag 'unfurl_id', desc: 'The ID of the link to unfurl. Both unfurl_id and source must be provided together, or channel and ts must be provided together.'
           c.flag 'source', desc: '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.'
-          c.flag 'metadata', desc: 'JSON object with entity_type and entity_payload fields, presented as a URL-encoded string. Either unfurls or metadata must be provided.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.chat_unfurl(options))
           end
@@ -188,6 +197,7 @@ module Slack
         g.command 'update' do |c|
           c.flag 'as_user', desc: 'Pass true to update the message as the authed user. Bot users in this context are considered authed users.'
           c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
+          c.flag 'unfurled_attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
           c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
           c.flag 'markdown_text', desc: '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.'
           c.flag 'metadata', desc: "JSON object with event_type and event_payload fields, presented as a URL-encoded string. If you don't include this field, the message's previous metadata will be retained. To remove previous metadata, include an empty object for this field. Metadata you post to Slack is accessible to any app or user who is a member of that workspace."

data/bin/commands/conversations.rb

@@ -24,7 +24,7 @@ module Slack
         g.long_desc %( Approves an invitation to a Slack Connect channel )
         g.command 'approveSharedInvite' do |c|
           c.flag 'invite_id', desc: 'ID of the shared channel invite to approve.'
-          c.flag 'target_team', desc: 'The team or enterprise id of the other party involved in the invitation you are approving.'
+          c.flag 'target_team', desc: 'The team or enterprise ID of the receiving party involved in the invitation you are approving.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_approveSharedInvite(options))
           end
@@ -100,7 +100,7 @@ module Slack
         g.command 'invite' do |c|
           c.flag 'channel', desc: 'The ID of the public or private channel to invite user(s) to.'
           c.flag 'force', desc: 'When set to true and multiple user IDs are provided, continue inviting the valid ones while disregarding invalid IDs. Defaults to false.'
-          c.flag 'users', desc: 'A comma separated list of user IDs. Up to 100 users may be listed.'
+          c.flag 'users', desc: 'A comma separated list of user IDs. Up to 1000 users may be listed.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_invite(options))
           end

data/bin/commands/conversations_canvases.rb

@@ -10,7 +10,7 @@ module Slack
         g.long_desc %( Create a channel canvas for a channel )
         g.command 'create' do |c|
           c.flag 'channel_id', desc: 'Channel ID of the channel the canvas will be tabbed in.'
-          c.flag 'document_content', desc: 'Structure describing the type and value of the content to create.'
+          c.flag 'document_content', desc: 'Structure describing the type and value of the content to create. The markdown content is limited to 1 MiB (1,048,576 characters).'
           c.flag 'title', desc: 'Title of the newly created canvas.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_canvases_create(options))

data/bin/commands/entity.rb

@@ -6,6 +6,33 @@ module Slack
     class App
       desc 'Entity methods.'
       command 'entity' do |g|
+        g.desc '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.'
+        g.long_desc %( 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. )
+        g.command 'acknowledgeCommentAction' do |c|
+          c.flag 'trigger_id', desc: 'A reference to the original user action that initiated the comment mutation.'
+          c.flag 'comment', desc: 'The full comment data. Required for edit and post actions. See the comment schema for the full list of properties.'
+          c.flag 'error', desc: 'Error message if the action failed in the app. When present, signals that the mutation could not be completed.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.entity_acknowledgeCommentAction(options))
+          end
+        end
+
+        g.desc 'Provide comments for work objects. Apps call this endpoint to send per-user flexpane comment data to the client.'
+        g.long_desc %( Provide comments for work objects. Apps call this endpoint to send per-user flexpane comment data to the client. )
+        g.command 'presentComments' do |c|
+          c.flag 'comments', desc: 'Array of comments to present to the user. See the comment schema for the full list of properties.'
+          c.flag 'cursor', desc: 'App supplied cursor used for pagination, will be sent in the next request for comments.'
+          c.flag 'can_post_comment', desc: 'Indicates whether the user has permissions to post comments.'
+          c.flag 'trigger_id', desc: 'A reference to the original user action that initiated the request.'
+          c.flag 'delete_action_id', desc: 'The block action id that will be sent when a delete request is initiated for a comment.'
+          c.flag 'user_auth_required', desc: 'Set to true (or 1) to indicate that the user must authenticate to see the comments data.'
+          c.flag 'user_auth_url', desc: 'A custom URL to which users are directed for authentication if required.'
+          c.flag 'error', desc: ''
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.entity_presentComments(options))
+          end
+        end
+
         g.desc 'Provide custom flexpane behavior for Work Objects. Apps call this endpoint to send per-user flexpane metadata to the client.'
         g.long_desc %( Provide custom flexpane behavior for Work Objects. Apps call this endpoint to send per-user flexpane metadata to the client. )
         g.command 'presentDetails' do |c|

data/bin/commands/files.rb

@@ -15,6 +15,9 @@ module Slack
           c.flag 'channels', desc: 'Comma-separated string of channel IDs or user IDs where the file will be shared.'
           c.flag 'initial_comment', desc: 'The message text introducing the file in specified channels.'
           c.flag 'blocks', desc: '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.'
+          c.flag 'username', desc: "Set your bot's user name for the file share message. Requires the chat:write.customize scope."
+          c.flag 'icon_url', desc: 'URL to an image to use as the icon for the file share message. Requires the chat:write.customize scope.'
+          c.flag 'icon_emoji', desc: 'Emoji to use as the icon for the file share message. Overrides icon_url. Requires the chat:write.customize scope.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.files_completeUploadExternal(options))
           end
@@ -63,8 +66,8 @@ module Slack
           end
         end
 
-        g.desc 'List for a team, in a channel, or from a user with applied filters.'
-        g.long_desc %( List for a team, in a channel, or from a user with applied filters. )
+        g.desc 'List files for a team, in a channel, or from a user with applied filters.'
+        g.long_desc %( List files for a team, in a channel, or from a user with applied filters. )
         g.command 'list' do |c|
           c.flag 'channel', desc: 'Filter files appearing in a specific channel, indicated by its ID.'
           c.flag 'show_files_hidden_by_limit', desc: 'Show truncated file info for files hidden due to being too old, and the team who owns the file being over the file limit.'

data/bin/commands/oauth_v2.rb

@@ -16,11 +16,33 @@ module Slack
           c.flag 'redirect_uri', desc: 'This must match the originally submitted URI (if one was sent).'
           c.flag 'grant_type', desc: 'The grant_type param as described in the OAuth spec.'
           c.flag 'refresh_token', desc: 'The refresh_token param as described in the OAuth spec.'
+          c.flag 'assertion', desc: 'Identity assertion JWT authorization grant.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.oauth_v2_access(options))
           end
         end
 
+        g.desc '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.'
+        g.long_desc %( 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. )
+        g.command 'beginShortTokenRotation' do |c|
+          c.flag 'client_id', desc: 'Issued when you created your application. Must be the app the token being rotated was issued to.'
+          c.flag 'client_secret', desc: 'Issued when you created your application.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.oauth_v2_beginShortTokenRotation(options))
+          end
+        end
+
+        g.desc '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.'
+        g.long_desc %( 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. )
+        g.command 'completeShortTokenRotation' do |c|
+          c.flag 'client_id', desc: 'Issued when you created your application. Must be the app the token being rotated was issued to.'
+          c.flag 'client_secret', desc: 'Issued when you created your application.'
+          c.flag 'new_token', desc: 'The new xoxp token returned by oauth.v2.beginShortTokenRotation.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.oauth_v2_completeShortTokenRotation(options))
+          end
+        end
+
         g.desc 'Exchanges a legacy access token for a new expiring access token and refresh token'
         g.long_desc %( Exchanges a legacy access token for a new expiring access token and refresh token )
         g.command 'exchange' do |c|

data/bin/commands/oauth_v2_user.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'OauthV2User methods.'
+      command 'oauth_v2_user' do |g|
+        g.desc 'Exchanges a temporary OAuth verifier code for a user access token.'
+        g.long_desc %( Exchanges a temporary OAuth verifier code for a user access token. )
+        g.command 'access' do |c|
+          c.flag 'client_id', desc: '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.'
+          c.flag 'client_secret', desc: '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.'
+          c.flag 'code', desc: 'The code param returned via the OAuth callback.'
+          c.flag 'code_verifier', desc: 'The code_verifier param used to generate the code_challenge originally. Used for PKCE.'
+          c.flag 'redirect_uri', desc: 'This must match the originally submitted URI (if one was sent).'
+          c.flag 'grant_type', desc: 'The grant_type param as described in the OAuth spec.'
+          c.flag 'refresh_token', desc: 'The refresh_token param as described in the OAuth spec.'
+          c.flag 'assertion', desc: 'Identity assertion JWT authorization grant.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.oauth_v2_user_access(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/openid_connect.rb

@@ -15,6 +15,7 @@ module Slack
           c.flag 'redirect_uri', desc: 'This must match the originally submitted URI (if one was sent).'
           c.flag 'grant_type', desc: 'The grant_type param as described in the OAuth spec.'
           c.flag 'refresh_token', desc: 'The refresh_token param as described in the OAuth spec.'
+          c.flag 'code_verifier', desc: 'PKCE code verifier (RFC 7636). Required when the authorization request included a code_challenge.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.openid_connect_token(options))
           end

data/bin/commands/slackLists_download.rb

@@ -11,6 +11,9 @@ module Slack
         g.command 'get' do |c|
           c.flag 'list_id', desc: 'ID of the List to export.'
           c.flag 'job_id', desc: 'The ID of the recently started job to export the List.'
+          c.flag 'format', desc: 'Format the export was started with. Must match the format passed to slackLists.download.start. Defaults to csv.'
+          c.flag 'include_threads', desc: '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.'
+          c.flag 'include_attachments', desc: '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.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.slackLists_download_get(options))
           end
@@ -21,6 +24,9 @@ module Slack
         g.command 'start' do |c|
           c.flag 'list_id', desc: 'ID of the List to export.'
           c.flag 'include_archived', desc: ''
+          c.flag 'format', desc: 'Format of the export. Defaults to csv for backward compatibility. Use json for a complete, hierarchical export.'
+          c.flag 'include_threads', desc: "Include each item's conversation thread in the export. Only applies when format is json."
+          c.flag 'include_attachments', desc: 'Include file attachment metadata and access paths in the export. Only applies when format is json.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.slackLists_download_start(options))
           end

data/bin/commands/slackLists_items.rb

@@ -56,6 +56,7 @@ module Slack
           c.flag 'limit', desc: 'The maximum number of records to return.'
           c.flag 'cursor', desc: 'Next cursor for pagination.'
           c.flag 'archived', desc: 'Boolean indicating whether archived items or normal items should be returned.'
+          c.flag 'include_list', desc: '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.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.slackLists_items_list(options))
           end

data/bin/commands/users.rb

@@ -6,11 +6,12 @@ module Slack
     class App
       desc 'Users methods.'
       command 'users' do |g|
-        g.desc 'List conversations the calling user may access.'
-        g.long_desc %( List conversations the calling user may access. )
+        g.desc 'List conversations the calling user is a member of.'
+        g.long_desc %( List conversations the calling user is a member of. )
         g.command 'conversations' do |c|
           c.flag 'cursor', desc: "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first 'page' of the collection. See pagination for more detail."
           c.flag 'exclude_archived', desc: 'Set to true to exclude archived channels from the list.'
+          c.flag 'exclude_muted', desc: 'Set to true to exclude muted channels from the list.'
           c.flag 'limit', desc: "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."
           c.flag 'team_id', desc: 'encoded team id to list conversations in, required if org token is used.'
           c.flag 'types', desc: 'Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im.'

data/bin/commands/views.rb

@@ -23,6 +23,7 @@ module Slack
           c.flag 'user_id', desc: 'id of the user you want publish a view to.'
           c.flag 'view', desc: 'A view payload. This must be a JSON-encoded string.'
           c.flag 'hash', desc: 'A string that represents view state to protect against possible race conditions.'
+          c.flag 'interactivity_pointer', desc: ''
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.views_publish(options))
           end

data/bin/slack

@@ -1,5 +1,9 @@
 #!/usr/bin/env ruby
-require 'gli'
+begin
+  require 'gli'
+rescue LoadError
+  abort "The slack command-line client requires the gli gem. Add `gem 'gli'` to your Gemfile, or run `gem install gli`."
+end
 require 'slack_ruby_client'
 
 module Slack

data/examples/files_upload_v2/files_upload_v2.rb

@@ -3,7 +3,7 @@ require 'slack-ruby-client'
 require 'securerandom'
 
 Slack.configure do |config|
-  config.token = ENV['SLACK_API_TOKEN']
+  config.token = ENV.fetch('SLACK_API_TOKEN', nil)
   raise 'Missing ENV[SLACK_API_TOKEN]!' unless config.token
 end
 

data/examples/hi_web/hi.rb

@@ -2,7 +2,7 @@
 require 'slack-ruby-client'
 
 Slack.configure do |config|
-  config.token = ENV['SLACK_API_TOKEN']
+  config.token = ENV.fetch('SLACK_API_TOKEN', nil)
   raise 'Missing ENV[SLACK_API_TOKEN]!' unless config.token
 end
 

data/examples/new_ticket/new_ticket.rb

@@ -2,7 +2,7 @@
 require 'slack-ruby-client'
 
 Slack.configure do |config|
-  config.token = ENV['SLACK_API_TOKEN']
+  config.token = ENV.fetch('SLACK_API_TOKEN', nil)
   raise 'Missing ENV[SLACK_API_TOKEN]!' unless config.token
 end
 

data/examples/oauth_v2/oauth_v2.rb

@@ -18,8 +18,8 @@ server.mount_proc '/' do |req, res|
 
   response = client.oauth_v2_access(
     req.query.merge(
-      client_id: ENV['SLACK_CLIENT_ID'],
-      client_secret: ENV['SLACK_CLIENT_SECRET'],
+      client_id: ENV.fetch('SLACK_CLIENT_ID', nil),
+      client_secret: ENV.fetch('SLACK_CLIENT_SECRET', nil),
       grant_type: 'authorization_code'
     )
   )
@@ -47,10 +47,10 @@ server.mount_proc '/' do |req, res|
 end
 
 query = {
-  client_id: ENV['SLACK_CLIENT_ID'],
-  redirect_uri: ENV['REDIRECT_URI'],
-  scope: ENV['SCOPE'],
-  user_scope: ENV['USER_SCOPE']
+  client_id: ENV.fetch('SLACK_CLIENT_ID', nil),
+  redirect_uri: ENV.fetch('REDIRECT_URI', nil),
+  scope: ENV.fetch('SCOPE', nil),
+  user_scope: ENV.fetch('USER_SCOPE', nil)
 }
 
 url = "https://slack.com/oauth/v2/authorize?#{query.to_query}"

data/lib/slack/events/config.rb

@@ -12,7 +12,7 @@ module Slack
       attr_accessor(*Config::ATTRIBUTES)
 
       def reset
-        self.signing_secret = ENV['SLACK_SIGNING_SECRET']
+        self.signing_secret = ENV.fetch('SLACK_SIGNING_SECRET', nil)
         self.signature_expires_in = 5 * 60
       end
     end

data/lib/slack/events/request.rb

@@ -40,9 +40,9 @@ module Slack
       def body
         @body ||= begin
           input = http_request.body
-          input.rewind
+          input.rewind if input.respond_to?(:rewind)
           body = input.read
-          input.rewind
+          input.rewind if input.respond_to?(:rewind)
           body
         end
       end

data/lib/slack/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module Slack
-  VERSION = '3.1.0'
+  VERSION = '3.3.0'
 end

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

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AdminAnalyticsMessages
+          #
+          # Retrieves activity metrics for messages from a given channel.
+          #
+          # @option options [channel] :channel
+          #   Channel ID for channel of the message activity to query.
+          # @option options [string] :oldest_ts
+          #   Oldest timestamp to include in the results. Defaults to 7 days before current time. If not passed while still passing the latest_ts parameter, defaults to 7 days before latest_ts.
+          # @option options [string] :latest_ts
+          #   Most recent timestamp to include in results. Defaults to current time. If not passed while still passing the oldest_ts parameter, defaults to 7 days after oldest_ts.
+          # @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.
+          # @option options [integer] :limit
+          #   Maximum number of entries to return. Defaults to 50 if not passed. Max allowed is 100.
+          # @see https://api.slack.com/methods/admin.analytics.messages.activity
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.analytics.messages/admin.analytics.messages.activity.json
+          def admin_analytics_messages_activity(options = {})
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
+            if block_given?
+              Pagination::Cursor.new(self, :admin_analytics_messages_activity, options).each do |page|
+                yield page
+              end
+            else
+              post('admin.analytics.messages.activity', options)
+            end
+          end
+
+          #
+          # Retrieves metadata for a list of messages from a given channel.
+          #
+          # @option options [channel] :channel
+          #   Channel ID for channel containing the messages to query.
+          # @option options [string] :oldest_ts
+          #   Oldest timestamp to include in the results.
+          # @option options [string] :latest_ts
+          #   Most recent timestamp to include in the results. If not passed, defaults to current time.
+          # @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.
+          # @see https://api.slack.com/methods/admin.analytics.messages.metadata
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.analytics.messages/admin.analytics.messages.metadata.json
+          def admin_analytics_messages_metadata(options = {})
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
+            if block_given?
+              Pagination::Cursor.new(self, :admin_analytics_messages_metadata, options).each do |page|
+                yield page
+              end
+            else
+              post('admin.analytics.messages.metadata', options)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -9,6 +9,8 @@ module Slack
           #
           # Approve an app for installation on a workspace.
           #
+          # @option options [boolean] :allow_child_auto_install
+          #   Auto-create an Admin-Approved App automation rule that pre-approves future child app installs from this manager app.
           # @option options [string] :app_id
           #   The id of the app to approve.
           # @option options [string] :request_id
@@ -17,6 +19,10 @@ module Slack
           #   The ID of the workspace to approve the app on.
           # @option options [Object] :enterprise_id
           #   The ID of the enterprise to approve the app on.
+          # @option options [string] :user_scopes
+          #   User scopes to approve for the app.
+          # @option options [string] :bot_scopes
+          #   Bot scopes to approve for the app.
           # @see https://api.slack.com/methods/admin.apps.approve
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.apps/admin.apps.approve.json
           def admin_apps_approve(options = {})

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

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AdminAppsMcpServers
+          #
+          # List third-party app MCP servers approved for an organization, derived from the org's MCP server allowlist. Entries reflect allowlist state, not install/scope liveness: servers of apps that are uninstalled (but not deleted) are still listed.
+          #
+          # @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.apps.mcp.servers.list
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.apps.mcp.servers/admin.apps.mcp.servers.list.json
+          def admin_apps_mcp_servers_list(options = {})
+            if block_given?
+              Pagination::Cursor.new(self, :admin_apps_mcp_servers_list, options).each do |page|
+                yield page
+              end
+            else
+              post('admin.apps.mcp.servers.list', options)
+            end
+          end
+        end
+      end
+    end
+  end
+end