slack-ruby-client 3.2.0 → 3.3.0

data/bin/commands/admin_apps_permissions.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AdminAppsPermissions methods.'
+      command 'admin_apps_permissions' do |g|
+        g.desc 'Grant permission for entities to access an app that has its permission type set to named_entities'
+        g.long_desc %( Grant permission for entities to access an app that has its permission type set to named_entities )
+        g.command 'add' do |c|
+          c.flag 'app_id', desc: 'Encoded ID of the app.'
+          c.flag 'user_ids', desc: 'List of user IDs to allow for named_entities visibility.'
+          c.flag 'usergroup_ids', desc: 'List of encoded usergroup IDs.'
+          c.flag 'channel_ids', desc: "List of encoded channel IDs to add to the channel restriction list. Interpretation depends on the app's channel_restriction_mode, which is configured via the admin.apps.permissions.set method."
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_permissions_add(options))
+          end
+        end
+
+        g.desc 'Returns the permission type of an app and if applicable, includes the entities that have been granted access'
+        g.long_desc %( Returns the permission type of an app and if applicable, includes the entities that have been granted access )
+        g.command 'list' do |c|
+          c.flag 'app_id', desc: 'Encoded ID of the app.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_permissions_list(options))
+          end
+        end
+
+        g.desc "Revoke an entity's access to an app that has its permission type set to named_entities"
+        g.long_desc %( Revoke an entity's access to an app that has its permission type set to named_entities )
+        g.command 'remove' do |c|
+          c.flag 'app_id', desc: 'Encoded ID of the app.'
+          c.flag 'user_ids', desc: 'List of user IDs whose named_entities access will be revoked.'
+          c.flag 'usergroup_ids', desc: 'List of encoded usergroup IDs.'
+          c.flag 'channel_ids', desc: "List of encoded channel IDs to remove from the channel restriction list. Interpretation depends on the app's channel_restriction_mode, which is configured via the admin.apps.permissions.set method."
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_permissions_remove(options))
+          end
+        end
+
+        g.desc 'Set the permission type for who can access an app'
+        g.long_desc %( Set the permission type for who can access an app )
+        g.command 'set' do |c|
+          c.flag 'app_id', desc: 'Encoded ID of the app.'
+          c.flag 'permission_type', desc: 'The type of permission that defines who can access the app.'
+          c.flag 'user_ids', desc: 'List of user IDs to allow for named_entities visibility.'
+          c.flag 'usergroup_ids', desc: 'List of encoded usergroup IDs.'
+          c.flag 'channel_restriction_mode', desc: 'The mode that defines where the app can be used in channels.'
+          c.flag 'channel_ids', desc: 'List of encoded channel IDs for channel restrictions. Semantics depend on channel_restriction_mode: allowlist for specific_channels, exclusion list for all_channels_except.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_permissions_set(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/admin_conversations.rb

@@ -43,8 +43,8 @@ module Slack
           end
         end
 
-        g.desc 'Exclude channels from Slack AI in bulk'
-        g.long_desc %( Exclude channels from Slack AI in bulk )
+        g.desc 'Exclude channels from Slack AI in bulk.'
+        g.long_desc %( Exclude channels from Slack AI in bulk. )
         g.command 'bulkSetExcludeFromSlackAi' do |c|
           c.flag 'channel_ids', desc: 'An array of channel IDs to exclude from Slack AI.'
           c.flag 'exclude', desc: 'Whether the channels should be excluded from Slack AI.'
@@ -53,6 +53,16 @@ module Slack
           end
         end
 
+        g.desc 'Set properties on channels in bulk.'
+        g.long_desc %( Set properties on channels in bulk. )
+        g.command 'bulkSetProperties' do |c|
+          c.flag 'channel_ids', desc: 'An array of channel IDs on which to set the property.'
+          c.flag 'property', desc: 'The property for this channel in a key value format. Only one property can be updated at a time.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_conversations_bulkSetProperties(options))
+          end
+        end
+
         g.desc 'Convert a public channel to a private channel.'
         g.long_desc %( Convert a public channel to a private channel. )
         g.command 'convertToPrivate' do |c|

data/bin/commands/admin_functions.rb

@@ -11,7 +11,7 @@ module Slack
         g.command 'list' do |c|
           c.flag 'team_id', desc: 'The team context to retrieve functions from.'
           c.flag 'app_ids', desc: 'Comma-separated array of app IDs to get functions for; max 50.'
-          c.flag 'include_non_distributed_functions', desc: 'Whether to also include functions that are not yet distributed to any users in the function count. This is needed for admins that are approving an app request and will only work if the team owns the app.'
+          c.flag 'include_non_distributed_functions', desc: 'Whether to also include functions that are not yet distributed to any users in the function list. This is needed for admins that are approving an app request and will only work if the team owns the app.'
           c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
           c.flag 'limit', desc: 'The number of results that will be returned by the API on each invocation. Must be between 1 and 1000, both inclusive.'
           c.action do |_global_options, options, _args|

data/bin/commands/admin_usergroups.rb

@@ -28,6 +28,37 @@ module Slack
           end
         end
 
+        g.desc 'Add members to an existing organizational usergroup. This method is only available to Enterprise Grid organizations.'
+        g.long_desc %( Add members to an existing organizational usergroup. This method is only available to Enterprise Grid organizations. )
+        g.command 'addUsers' do |c|
+          c.flag 'id', desc: 'ID of the usergroup to add users to.'
+          c.flag 'users', desc: 'The encoded user IDs to add to the usergroup, provided as a JSON array or a comma-separated string.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_usergroups_addUsers(options))
+          end
+        end
+
+        g.desc 'Create a new organizational usergroup. This method is only available to Enterprise Grid organizations.'
+        g.long_desc %( Create a new organizational usergroup. This method is only available to Enterprise Grid organizations. )
+        g.command 'create' do |c|
+          c.flag 'name', desc: 'Unique name for the usergroup.'
+          c.flag 'handle', desc: 'Optional handle used to mention the usergroup in channel, must be unique.'
+          c.flag 'purpose', desc: 'Optional purpose that describes what the usergroup is about.'
+          c.flag 'is_visible', desc: 'Configure whether or not this usergroup should be visible in the client.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_usergroups_create(options))
+          end
+        end
+
+        g.desc 'Fetch an organizational usergroup.'
+        g.long_desc %( Fetch an organizational usergroup. )
+        g.command 'fetch' do |c|
+          c.flag 'id', desc: 'ID of the usergroup to fetch.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_usergroups_fetch(options))
+          end
+        end
+
         g.desc 'List the channels linked to an org-level IDP group (user group).'
         g.long_desc %( List the channels linked to an org-level IDP group (user group). )
         g.command 'listChannels' do |c|
@@ -48,6 +79,49 @@ module Slack
             puts JSON.dump(@client.admin_usergroups_removeChannels(options))
           end
         end
+
+        g.desc 'Remove one or more default workspaces from an organization-wide IDP Group or Admin Group.'
+        g.long_desc %( Remove one or more default workspaces from an organization-wide IDP Group or Admin Group. )
+        g.command 'removeTeams' do |c|
+          c.flag 'usergroup_id', desc: 'An encoded usergroup (IDP Group) ID.'
+          c.flag 'team_ids', desc: 'A comma separated list of encoded team (workspace) IDs. Each workspace MUST belong to the organization associated with the token.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_usergroups_removeTeams(options))
+          end
+        end
+
+        g.desc 'Remove members from an existing organizational usergroup. This method is only available to Enterprise Grid organizations.'
+        g.long_desc %( Remove members from an existing organizational usergroup. This method is only available to Enterprise Grid organizations. )
+        g.command 'removeUsers' do |c|
+          c.flag 'id', desc: 'ID of the usergroup to remove users from.'
+          c.flag 'users', desc: 'The encoded user IDs to remove from the usergroup, provided as a JSON array or a comma-separated string.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_usergroups_removeUsers(options))
+          end
+        end
+
+        g.desc 'Update one or more properties of an existing organizational usergroup.'
+        g.long_desc %( Update one or more properties of an existing organizational usergroup. )
+        g.command 'update' do |c|
+          c.flag 'id', desc: 'ID of the usergroup to update.'
+          c.flag 'name', desc: 'The name of the group.'
+          c.flag 'handle', desc: 'The handle used for mentioning the group in a channel, must be unique.'
+          c.flag 'description', desc: "The usergroup's purpose or description."
+          c.flag 'is_visible', desc: 'Configure whether or not this usergroup should be visible in the client.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_usergroups_update(options))
+          end
+        end
+
+        g.desc 'Add members to an existing organizational usergroup in bulk via CSV upload. This method is only available to Enterprise Grid organizations.'
+        g.long_desc %( Add members to an existing organizational usergroup in bulk via CSV upload. This method is only available to Enterprise Grid organizations. )
+        g.command 'uploadUsers' do |c|
+          c.flag 'id', desc: 'ID of the usergroup to upload users to.'
+          c.flag 'file', desc: 'Csv of users to upload in format member id, email.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_usergroups_uploadUsers(options))
+          end
+        end
       end
     end
   end

data/bin/commands/admin_users_session.rb

@@ -27,7 +27,6 @@ module Slack
         g.desc 'Revoke a single session for a user. The user will be forced to login to Slack.'
         g.long_desc %( Revoke a single session for a user. The user will be forced to login to Slack. )
         g.command 'invalidate' do |c|
-          c.flag 'team_id', desc: 'ID of the workspace that the session belongs to.'
           c.flag 'user_id', desc: 'ID of the user that the session belongs to.'
           c.flag 'session_id', desc: 'ID of the session to invalidate.'
           c.action do |_global_options, options, _args|

data/bin/commands/agents_sessions.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AgentsSessions methods.'
+      command 'agents_sessions' do |g|
+        g.desc 'Rename an agent session.'
+        g.long_desc %( Rename an agent session. )
+        g.command 'rename' do |c|
+          c.flag 'channel_id', desc: 'ID of the channel containing the agent session. Required for public channels.'
+          c.flag 'title', desc: 'New title for the agent session (1-200 characters). For a session channel, this also renames the channel.'
+          c.flag 'thread_ts', desc: '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.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.agents_sessions_rename(options))
+          end
+        end
+
+        g.desc "Set an agent session's lifecycle status, creating the session if needed."
+        g.long_desc %( Set an agent session's lifecycle status, creating the session if needed. )
+        g.command 'setStatus' do |c|
+          c.flag 'channel_id', desc: 'ID of the channel containing the agent session. Required for public channels.'
+          c.flag 'status', desc: 'The lifecycle status to set.'
+          c.flag 'thread_ts', desc: '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.'
+          c.flag 'title', desc: '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.'
+          c.flag 'initiator_user_id', desc: '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.'
+          c.flag 'icon_emoji', desc: "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."
+          c.flag 'icon_url', desc: "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."
+          c.flag 'username', desc: '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.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.agents_sessions_setStatus(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/apps_managed_permissions.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AppsManagedPermissions methods.'
+      command 'apps_managed_permissions' do |g|
+        g.desc "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."
+        g.long_desc %( 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. )
+        g.command 'set' do |c|
+          c.flag 'app_id', desc: 'Encoded ID of the managed app to configure.'
+          c.flag 'permissions', desc: "Who can interact with the app. Use everyone to allow all members, or app_owner to restrict access to the app's owner."
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.apps_managed_permissions_set(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/assistant_threads.rb

@@ -25,7 +25,7 @@ module Slack
         g.long_desc %( Set suggested prompts for the given assistant thread )
         g.command 'setSuggestedPrompts' do |c|
           c.flag 'channel_id', desc: 'Channel ID containing the assistant thread.'
-          c.flag 'thread_ts', desc: 'Message timestamp of the thread to set suggested prompts for.'
+          c.flag 'thread_ts', desc: '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.'
           c.flag 'prompts', desc: 'Each prompt should be supplied with its title and message attribute.'
           c.flag 'title', desc: 'Title for the list of provided prompts. For example: Suggested Prompts, Related Questions.'
           c.action do |_global_options, options, _args|

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

@@ -82,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."
@@ -113,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
@@ -143,13 +145,13 @@ 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 thread or DM.'
-          c.flag 'chunks', desc: 'Array of streaming chunks.'
+          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. 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."
+          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."
@@ -162,11 +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.'
+          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
@@ -177,7 +180,7 @@ module Slack
         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. 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 the message, pointing to their unfurl blocks or message attachments. 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.'

data/bin/commands/conversations.rb

@@ -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

data/bin/commands/oauth_v2.rb

@@ -22,6 +22,27 @@ module Slack
           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|