Update API from slack-api-ref@3ec3c10 (2024-12-14)

Author: web-flow

CHANGELOG.md

@@ -3,6 +3,7 @@
 * [#525](https://github.com/slack-ruby/slack-ruby-client/pull/525): Exclude spec files from gem package - [@amatsuda](https://github.com/amatsuda).
 * [#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).
+* [#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,7 +10,7 @@ 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.'

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,7 +20,7 @@ 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 (e.g. read, write, owner).'
           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.'

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.'

bin/commands/conversations.rb

@@ -111,7 +111,7 @@ class App
         g.command 'inviteShared' do |c|
           c.flag 'channel', desc: "ID of the channel on your team that you'd like to share."
           c.flag 'emails', desc: 'Optional email to receive this invite. Either emails or user_ids must be provided. Only one email or one user ID may be invited at a time.'
-          c.flag 'external_limited', desc: 'Optional boolean on whether invite is to a external limited member. Defaults to true.'
+          c.flag 'external_limited', desc: 'Optional boolean on whether invite is to an external limited member. Defaults to true.'
           c.flag 'user_ids', desc: 'Optional user_id to receive this invite. Either emails or user_ids must be provided. Only one email or one user ID may be invited at a time.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_inviteShared(options))
@@ -228,11 +228,11 @@ class App
           end
         end
 
-        g.desc 'Sets the purpose for a conversation.'
-        g.long_desc %( Sets the purpose for a conversation. )
+        g.desc 'Sets the channel description.'
+        g.long_desc %( Sets the channel description. )
         g.command 'setPurpose' do |c|
-          c.flag 'channel', desc: 'Conversation to set the purpose of.'
-          c.flag 'purpose', desc: 'A new, specialer purpose.'
+          c.flag 'channel', desc: 'Channel to set the description of.'
+          c.flag 'purpose', desc: 'The description.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.conversations_setPurpose(options))
           end