Update API from slack-api-ref@3ec3c10 (2025-01-14)

Author: web-flow

CHANGELOG.md

@@ -4,6 +4,7 @@
 * [#527](https://github.com/slack-ruby/slack-ruby-client/pull/527): Explicitly require `racc` and `ostruct` - [@dblock](https://github.com/dblock).
 * [#528](https://github.com/slack-ruby/slack-ruby-client/pull/528): Don't treat asterisks in list items as italic in markdown - [@rspeicher](https://github.com/rspeicher).
 * [#530](https://github.com/slack-ruby/slack-ruby-client/pull/530): Specify dependency on logger - [@rwstauner](https://github.com/rwstauner).
+* [#524](https://github.com/slack-ruby-client/pulls/524): Update API from [slack-api-ref@3ec3c10](https://github.com/slack-ruby/slack-api-ref/commit/3ec3c10) - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
 * Your contribution here.
 
 ### 2.4.0 (2024/07/14)

bin/commands/admin_conversations.rb

@@ -133,6 +133,17 @@ class App
           end
         end
 
+        g.desc 'Link a Salesforce record to a channel'
+        g.long_desc %( Link a Salesforce record to a channel )
+        g.command 'linkObjects' do |c|
+          c.flag 'channel', desc: 'Channel ID for Slack channel that will be linked to a Salesforce record.'
+          c.flag 'record_id', desc: 'Salesforce record ID (15 or 18 digit accepted). See here for how to look up record ID.'
+          c.flag 'salesforce_org_id', desc: 'Salesforce org ID (15 or 18 digit accepted). See here for how to look up Salesforce org ID.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_conversations_linkObjects(options))
+          end
+        end
+
         g.desc 'Returns channels on the given team using the filters.'
         g.long_desc %( Returns channels on the given team using the filters. )
         g.command 'lookup' do |c|
@@ -222,6 +233,16 @@ class App
             puts JSON.dump(@client.admin_conversations_unarchive(options))
           end
         end
+
+        g.desc 'Unlink a Salesforce record from a channel'
+        g.long_desc %( Unlink a Salesforce record from a channel )
+        g.command 'unlinkObjects' do |c|
+          c.flag 'channel', desc: 'Channel ID for Slack channel that will be unlinked from the Salesforce record.'
+          c.flag 'new_name', desc: 'Channel name you would like to give to the channel that is being unlinked from the Salesforce record.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_conversations_unlinkObjects(options))
+          end
+        end
       end
     end
   end

bin/commands/admin_users_session.rb

@@ -28,6 +28,7 @@ class App
         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 'session_id', desc: 'ID of the session to invalidate.'
+          c.flag 'user_id', desc: 'ID of the user that the session belongs to.'
           c.flag 'team_id', desc: 'ID of the workspace that the session belongs to.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_users_session_invalidate(options))

bin/commands/admin_workflows.rb

@@ -10,16 +10,18 @@ class App
         g.long_desc %( Search workflows within the team or enterprise )
         g.command 'search' do |c|
           c.flag 'app_id', desc: 'The parent app ID for which to return workflows.'
-          c.flag 'collaborator_ids', desc: 'Only include workflows where the provided user IDs are a manager/collaborator of that workflow.'
+          c.flag 'collaborator_ids', desc: 'Only include workflows where all of the provided user IDs are a manager/collaborator of that workflow.'
           c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
           c.flag 'is_sales_elevate', desc: 'Filter workflows by their Sales Elevate status.'
           c.flag 'limit', desc: 'The number of results that will be returned by the API on each invocation.'
           c.flag 'no_collaborators', desc: 'Only include workflows with no collaborators in the result; default is false.'
           c.flag 'num_trigger_ids', desc: 'Number of trigger IDs to fetch for each workflow; default is 10.'
+          c.flag 'publish_status', desc: 'Filter workflows by their published status.'
           c.flag 'query', desc: 'A search query to filter for workflow name or description.'
           c.flag 'sort', desc: 'The field used to sort the returned workflows.'
           c.flag 'sort_dir', desc: 'Sort direction. Possible values are asc for ascending order like (1, 2, 3) or (a, b, c), and desc for descending order like (3, 2, 1) or (c, b, a).'
           c.flag 'source', desc: 'Source of workflow creation, either from code or workflow builder.'
+          c.flag 'step_function_ids', desc: 'Only include workflows that use all of the provided step function ids.'
           c.flag 'trigger_type_id', desc: 'Only include workflows with this trigger type.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_workflows_search(options))

bin/commands/admin_workflows_triggers_types_permissions.rb

@@ -6,17 +6,17 @@ module Cli
     class App
       desc 'AdminWorkflowsTriggersTypesPermissions methods.'
       command 'admin_workflows_triggers_types_permissions' do |g|
-        g.desc 'list the permissions for using each trigger type in workflow builder'
-        g.long_desc %( list the permissions for using each trigger type in workflow builder )
+        g.desc 'list the permissions for using each trigger type'
+        g.long_desc %( list the permissions for using each trigger type )
         g.command 'lookup' do |c|
           c.flag 'trigger_type_ids', desc: 'The trigger types IDs for which to get the permissions.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.admin_workflows_triggers_types_permissions_lookup(options))
           end
         end
 
-        g.desc 'Set the permissions for using a trigger type in workflow builder'
-        g.long_desc %( Set the permissions for using a trigger type in workflow builder )
+        g.desc 'Set the permissions for using a trigger type'
+        g.long_desc %( Set the permissions for using a trigger type )
         g.command 'set' do |c|
           c.flag 'id', desc: 'The trigger type ID for which to set the permissions.'
           c.flag 'visibility', desc: 'The function visibility.'

bin/commands/assistant_threads.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AssistantThreads methods.'
+      command 'assistant_threads' do |g|
+        g.desc 'Set the status for an AI assistant thread.'
+        g.long_desc %( Set the status for an AI assistant thread. )
+        g.command 'setStatus' do |c|
+          c.flag 'channel_id', desc: 'Channel ID containing the assistant thread.'
+          c.flag 'status', desc: "Status of the specified bot user, e.g. 'is thinking...'."
+          c.flag 'thread_ts', desc: 'Message timestamp of the thread of where to set the status.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.assistant_threads_setStatus(options))
+          end
+        end
+
+        g.desc 'Set suggested prompts for the given assistant thread'
+        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 'prompts', desc: 'Each prompt should be supplied with its title and message attribute.'
+          c.flag 'thread_ts', desc: 'Message timestamp of the thread to set suggested prompts for.'
+          c.flag 'title', desc: 'Title for the list of provided prompts. For example: Suggested Prompts, Related Questions.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.assistant_threads_setSuggestedPrompts(options))
+          end
+        end
+
+        g.desc 'Set the title for the given assistant thread'
+        g.long_desc %( Set the title for the given assistant thread )
+        g.command 'setTitle' 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 'title', desc: 'The title to use for the thread.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.assistant_threads_setTitle(options))
+          end
+        end
+      end
+    end
+  end
+end

bin/commands/bookmarks.rb

@@ -12,6 +12,7 @@ class App
           c.flag 'channel_id', desc: 'Channel to add bookmark in.'
           c.flag 'title', desc: 'Title for the bookmark.'
           c.flag 'type', desc: 'Type of the bookmark i.e link.'
+          c.flag 'access_level', desc: "The level that we are setting the file's permission to (read or write)."
           c.flag 'emoji', desc: 'Emoji tag to apply to the link.'
           c.flag 'entity_id', desc: 'ID of the entity being bookmarked. Only applies to message and file types.'
           c.flag 'link', desc: 'Link to bookmark.'

bin/commands/canvases.rb

@@ -6,8 +6,8 @@ module Cli
     class App
       desc 'Canvases methods.'
       command 'canvases' do |g|
-        g.desc 'Create Canvas for a user.'
-        g.long_desc %( Create Canvas for a user. )
+        g.desc 'Create canvas for a user'
+        g.long_desc %( Create canvas for a user )
         g.command 'create' do |c|
           c.flag 'document_content', desc: 'Structure describing the type and value of the content to create.'
           c.flag 'title', desc: 'Title of the newly created canvas.'
@@ -16,8 +16,8 @@ class App
           end
         end
 
-        g.desc 'Deletes a canvas.'
-        g.long_desc %( Deletes a canvas. )
+        g.desc 'Deletes a canvas'
+        g.long_desc %( Deletes a canvas )
         g.command 'delete' do |c|
           c.flag 'canvas_id', desc: 'Encoded ID of the canvas.'
           c.action do |_global_options, options, _args|

bin/commands/canvases_access.rb

@@ -20,10 +20,10 @@ class App
         g.desc 'Sets the access level to a canvas for specified entities'
         g.long_desc %( Sets the access level to a canvas for specified entities )
         g.command 'set' do |c|
-          c.flag 'access_level', desc: 'Desired level of access (e.g. read, write).'
+          c.flag 'access_level', desc: 'Desired level of access.'
           c.flag 'canvas_id', desc: 'Encoded ID of the canvas.'
-          c.flag 'channel_ids', desc: 'List of channels you wish to update access for.'
-          c.flag 'user_ids', desc: 'List of users you wish to update access for.'
+          c.flag 'channel_ids', desc: 'List of channels you wish to update access for. Can only be used if user_ids is not provided.'
+          c.flag 'user_ids', desc: 'List of users you wish to update access for. Can only be used if channel_ids is not provided.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.canvases_access_set(options))
           end

bin/commands/chat.rb

@@ -82,11 +82,11 @@ class App
         g.desc 'Sends a message to a channel.'
         g.long_desc %( Sends a message to a channel. )
         g.command 'postMessage' do |c|
-          c.flag 'channel', desc: 'Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name. See below for more details.'
+          c.flag 'channel', desc: 'An encoded ID that represents a channel, private group, or IM channel to send the message to. See below for more details.'
           c.flag '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 '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 'as_user', desc: '(Legacy) Pass true to post the message as the authed user instead of as a bot. Defaults to false. Can only be used by classic Slack apps. See authorship below.'
+          c.flag 'as_user', desc: '(Legacy) Pass true to post the message as the authed user instead of as a bot. Defaults to false. Can only be used by classic apps. See legacy as_user parameter below.'
           c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url.'
           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.'