slack-ruby-client 0.14.1 → 0.14.2

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

@@ -6,7 +6,7 @@ module Slack
       module Endpoints
         module Api
           #
-          # Checks API calling code.
+          # This method helps you test your calling code.
           #
           # @option options [Object] :error
           #   Error response to return.

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

@@ -6,7 +6,7 @@ module Slack
       module Endpoints
         module Apps
           #
-          # Uninstalls your app from a workspace.
+          # This method uninstalls a workspace app. Unlike auth.revoke, which revokes a single token, this method revokes all tokens associated with a single installation of a workspace app.
           #
           # @option options [Object] :client_id
           #   Issued when you created your application.

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

@@ -6,7 +6,7 @@ module Slack
       module Endpoints
         module AppsPermissions
           #
-          # Returns list of permissions this app has on a team.
+          # This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.
           #
           # @see https://api.slack.com/methods/apps.permissions.info
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.permissions/apps.permissions.info.json
@@ -15,7 +15,7 @@ module Slack
           end
 
           #
-          # Allows an app to request additional scopes
+          # This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.
           #
           # @option options [Object] :scopes
           #   A comma separated list of scopes to request for.

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

@@ -6,7 +6,7 @@ module Slack
       module Endpoints
         module AppsPermissionsResources
           #
-          # Returns list of resource grants this app has on a team.
+          # This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.
           #
           # @option options [Object] :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.

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

@@ -6,7 +6,7 @@ module Slack
       module Endpoints
         module AppsPermissionsScopes
           #
-          # Returns list of scopes this app has on a team.
+          # This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.
           #
           # @see https://api.slack.com/methods/apps.permissions.scopes.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.permissions.scopes/apps.permissions.scopes.list.json

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

@@ -6,7 +6,7 @@ module Slack
       module Endpoints
         module AppsPermissionsUsers
           #
-          # Returns list of user grants and corresponding scopes this app has on a team.
+          # This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.
           #
           # @option options [Object] :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.
@@ -25,7 +25,7 @@ module Slack
           end
 
           #
-          # Enables an app to trigger a permissions modal to grant an app access to a user access scope.
+          # This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.
           #
           # @option options [Object] :scopes
           #   A comma separated list of user scopes to request for.

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

@@ -6,7 +6,7 @@ module Slack
       module Endpoints
         module Auth
           #
-          # Revokes a token.
+          # This method revokes an access token. Use it when you no longer need a token. For example, with a Sign In With Slack app, call this to log a user out.
           #
           # @option options [Object] :test
           #   Setting this parameter to 1 triggers a testing mode where the specified token will not actually be revoked.
@@ -17,7 +17,7 @@ module Slack
           end
 
           #
-          # Checks authentication & identity.
+          # This method checks authentication and tells "you" who you are, even if you might be a bot.
           #
           # @see https://api.slack.com/methods/auth.test
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/auth/auth.test.json

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

@@ -6,7 +6,7 @@ module Slack
       module Endpoints
         module Bots
           #
-          # Gets information about a bot user.
+          # This method returns extended information about a bot user.
           #
           # @option options [Object] :bot
           #   Bot user to get info on.

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

@@ -6,7 +6,7 @@ module Slack
       module Endpoints
         module Channels
           #
-          # Archives a channel.
+          # This method archives a channel.
           #
           # @option options [channel] :channel
           #   Channel to archive.
@@ -19,7 +19,7 @@ module Slack
           end
 
           #
-          # Creates a channel.
+          # This method is used to create a channel.
           #
           # @option options [Object] :name
           #   Name of channel to create.
@@ -46,7 +46,7 @@ module Slack
           end
 
           #
-          # Fetches history of messages and events from a channel.
+          # This method returns a portion of message events from the specified public channel.
           #
           # @option options [channel] :channel
           #   Channel to fetch history for.
@@ -67,7 +67,7 @@ module Slack
           end
 
           #
-          # Gets information about a channel.
+          # This method returns information about a team channel.
           #
           # @option options [channel] :channel
           #   Channel to get info on.
@@ -82,7 +82,7 @@ module Slack
           end
 
           #
-          # Invites a user to a channel.
+          # This method is used to invite a user to a channel. The calling user must be a member of the channel.
           #
           # @option options [channel] :channel
           #   Channel to invite user to.
@@ -99,7 +99,8 @@ module Slack
           end
 
           #
-          # Joins a channel, creating it if needed.
+          # This method is used to join a channel. If the channel does not exist, it is
+          # created.
           #
           # @option options [Object] :name
           #   Name of channel to join.
@@ -113,7 +114,7 @@ module Slack
           end
 
           #
-          # Removes a user from a channel.
+          # This method allows a user to remove another member from a team channel.
           #
           # @option options [channel] :channel
           #   Channel to remove user from.
@@ -130,7 +131,7 @@ module Slack
           end
 
           #
-          # Leaves a channel.
+          # This method is used to leave a channel.
           #
           # @option options [channel] :channel
           #   Channel to leave.
@@ -143,7 +144,7 @@ module Slack
           end
 
           #
-          # Lists all channels in a Slack team.
+          # Don't use this method. Use conversations.list instead.
           #
           # @option options [Object] :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.
@@ -166,7 +167,7 @@ module Slack
           end
 
           #
-          # Sets the read cursor in a channel.
+          # This method moves the read cursor in a channel.
           #
           # @option options [channel] :channel
           #   Channel to set reading cursor in.
@@ -182,7 +183,7 @@ module Slack
           end
 
           #
-          # Renames a channel.
+          # This method renames a team channel.
           #
           # @option options [channel] :channel
           #   Channel to rename.
@@ -200,7 +201,7 @@ module Slack
           end
 
           #
-          # Retrieve a thread of messages posted to a channel
+          # This method returns an entire thread (a message plus all the messages in reply to it).
           #
           # @option options [channel] :channel
           #   Channel to fetch thread from.
@@ -216,12 +217,14 @@ module Slack
           end
 
           #
-          # Sets the purpose for a channel.
+          # This method is used to change the purpose of a channel. The calling user must be a member of the channel.
           #
           # @option options [channel] :channel
           #   Channel to set the purpose of.
           # @option options [Object] :purpose
           #   The new purpose.
+          # @option options [Object] :name_tagging
+          #   if it is true, treat this like a message and not an unescaped thing.
           # @see https://api.slack.com/methods/channels.setPurpose
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.setPurpose.json
           def channels_setPurpose(options = {})
@@ -232,7 +235,7 @@ module Slack
           end
 
           #
-          # Sets the topic for a channel.
+          # This method is used to change the topic of a channel. The calling user must be a member of the channel.
           #
           # @option options [channel] :channel
           #   Channel to set the topic of.
@@ -248,7 +251,7 @@ module Slack
           end
 
           #
-          # Unarchives a channel.
+          # This method unarchives a channel. The calling user is added to the channel.
           #
           # @option options [channel] :channel
           #   Channel to unarchive.

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

@@ -24,7 +24,7 @@ module Slack
           end
 
           #
-          # Deletes a message.
+          # This method deletes a message from a channel.
           #
           # @option options [channel] :channel
           #   Channel containing the message to be deleted.
@@ -42,7 +42,25 @@ module Slack
           end
 
           #
-          # Retrieve a permalink URL for a specific extant message
+          # This method deletes a pending scheduled message before it is sent.
+          #
+          # @option options [channel] :channel
+          #   The channel the scheduled_message is posting to.
+          # @option options [Object] :scheduled_message_id
+          #   scheduled_message_id returned from call to chat.scheduleMessage.
+          # @option options [Object] :as_user
+          #   Pass true to delete the message as the authed user with chat:write:user scope. Bot users in this context are considered authed users. If unused or false, the message will be deleted with chat:write:bot scope.
+          # @see https://api.slack.com/methods/chat.deleteScheduledMessage
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.deleteScheduledMessage.json
+          def chat_deleteScheduledMessage(options = {})
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            throw ArgumentError.new('Required arguments :scheduled_message_id missing') if options[:scheduled_message_id].nil?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('chat.deleteScheduledMessage', options)
+          end
+
+          #
+          # Easily exchange a message timestamp and a channel ID for a friendly HTTP-based permalink to that message. Handles message threads and all conversation types.
           #
           # @option options [channel] :channel
           #   The ID of the conversation or channel containing the message.
@@ -58,7 +76,7 @@ module Slack
           end
 
           #
-          # Share a me message into a channel.
+          # This method sends a me message to a channel from the calling user.
           #
           # @option options [channel] :channel
           #   Channel to send message to. Can be a public channel, private group or IM channel. Can be an encoded ID, or a name.
@@ -73,7 +91,7 @@ module Slack
           end
 
           #
-          # Sends an ephemeral message to a user in a channel.
+          # This method posts an ephemeral message, which is visible only to the assigned user in a specific public channel, private channel, or private conversation.
           #
           # @option options [channel] :channel
           #   Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name.
@@ -92,7 +110,7 @@ module Slack
           # @option options [Object] :parse
           #   Change how messages are treated. Defaults to none. See below.
           # @option options [Object] :thread_ts
-          #   Provide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead.
+          #   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.
           # @see https://api.slack.com/methods/chat.postEphemeral
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postEphemeral.json
           def chat_postEphemeral(options = {})
@@ -116,7 +134,7 @@ module Slack
           end
 
           #
-          # Sends a message to a channel.
+          # This method posts a message to a public channel, private channel, or direct message/IM channel.
           #
           # @option options [channel] :channel
           #   Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name. See below for more details.
@@ -169,14 +187,50 @@ module Slack
           end
 
           #
-          # Provide custom unfurl behavior for user-posted URLs
+          # This method schedules a message for delivery to a public channel, private channel, or direct message/IM channel at a specified time in the future.
+          #
+          # @option options [channel] :channel
+          #   Channel, private group, or DM channel to send message to. Can be an encoded ID, or a name. See below for more details.
+          # @option options [Object] :post_at
+          #   Unix EPOCH timestamp of time in future to send the message.
+          # @option options [Object] :text
+          #   Text of the message to send. See below for an explanation of formatting. This field is usually required, unless you're providing only attachments instead. Provide no more than 40,000 characters or risk truncation.
+          # @option options [Object] :as_user
+          #   Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below.
+          # @option options [Object] :attachments
+          #   A JSON-based array of structured attachments, presented as a URL-encoded string.
+          # @option options [Object] :blocks
+          #   A JSON-based array of structured blocks, presented as a URL-encoded string.
+          # @option options [Object] :link_names
+          #   Find and link channel names and usernames.
+          # @option options [Object] :parse
+          #   Change how messages are treated. Defaults to none. See below.
+          # @option options [Object] :reply_broadcast
+          #   Used in conjunction with thread_ts and indicates whether reply should be made visible to everyone in the channel or conversation. Defaults to false.
+          # @option options [Object] :thread_ts
+          #   Provide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead.
+          # @option options [Object] :unfurl_links
+          #   Pass true to enable unfurling of primarily text-based content.
+          # @option options [Object] :unfurl_media
+          #   Pass false to disable unfurling of media content.
+          # @see https://api.slack.com/methods/chat.scheduleMessage
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.scheduleMessage.json
+          def chat_scheduleMessage(options = {})
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            throw ArgumentError.new('Required arguments :post_at missing') if options[:post_at].nil?
+            throw ArgumentError.new('Required arguments :text missing') if options[:text].nil?
+            post('chat.scheduleMessage', options)
+          end
+
+          #
+          # This method attaches Slack app unfurl behavior to a specified and relevant message. A user token is required as this method does not support bot user tokens.
           #
           # @option options [channel] :channel
           #   Channel ID of the message.
           # @option options [timestamp] :ts
           #   Timestamp of the message to add unfurl behavior to.
           # @option options [Object] :unfurls
-          #   URL-encoded JSON map with keys set to URLs featured in the the message, pointing to their unfurl message attachments.
+          #   URL-encoded JSON map with keys set to URLs featured in the the message, pointing to their unfurl blocks or message attachments.
           # @option options [Object] :user_auth_message
           #   Provide a simply-formatted string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior.
           # @option options [Object] :user_auth_required
@@ -194,7 +248,7 @@ module Slack
           end
 
           #
-          # Updates a message.
+          # This method updates a message in a channel. Though related to chat.postMessage, some parameters of chat.update are handled differently.
           #
           # @option options [channel] :channel
           #   Channel containing the message to be updated.

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

@@ -0,0 +1,37 @@
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module ChatScheduledmessages
+          #
+          # This method returns a list of pending scheduled messages.
+          #
+          # @option options [channel] :channel
+          #   The channel of the scheduled messages.
+          # @option options [Object] :cursor
+          #   For pagination purposes, this is the cursor value returned from a previous call to chat.scheduledmessages.list indicating where you want to start this call from.
+          # @option options [timestamp] :latest
+          #   A UNIX timestamp of the latest value in the time range.
+          # @option options [Object] :limit
+          #   Maximum number of original entries to return.
+          # @option options [timestamp] :oldest
+          #   A UNIX timestamp of the oldest value in the time range.
+          # @see https://api.slack.com/methods/chat.scheduledMessages.list
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat.scheduledMessages/chat.scheduledMessages.list.json
+          def chat_scheduledMessages_list(options = {})
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            if block_given?
+              Pagination::Cursor.new(self, :chat_scheduledMessages_list, options).each do |page|
+                yield page
+              end
+            else
+              post('chat.scheduledMessages.list', options)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -6,7 +6,7 @@ module Slack
       module Endpoints
         module Conversations
           #
-          # Archives a conversation.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   ID of conversation to archive.
@@ -19,7 +19,7 @@ module Slack
           end
 
           #
-          # Closes a direct message or multi-person direct message.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   Conversation to close.
@@ -32,7 +32,7 @@ module Slack
           end
 
           #
-          # Initiates a public or private channel-based conversation
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [Object] :name
           #   Name of the public or private channel to create.
@@ -48,7 +48,7 @@ module Slack
           end
 
           #
-          # Fetches a conversation's history of messages and events.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   Conversation ID to fetch history for.
@@ -77,7 +77,7 @@ module Slack
           end
 
           #
-          # Retrieve information about a conversation.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   Conversation ID to learn more about.
@@ -94,7 +94,7 @@ module Slack
           end
 
           #
-          # Invites users to a channel.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   The ID of the public or private channel to invite user(s) to.
@@ -110,7 +110,7 @@ module Slack
           end
 
           #
-          # Joins an existing conversation.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   ID of conversation to join.
@@ -123,7 +123,7 @@ module Slack
           end
 
           #
-          # Removes a user from a conversation.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   ID of conversation to remove user from.
@@ -140,7 +140,7 @@ module Slack
           end
 
           #
-          # Leaves a conversation.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   Conversation to leave.
@@ -153,7 +153,7 @@ module Slack
           end
 
           #
-          # Lists all channels in a Slack team.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [Object] :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.
@@ -176,7 +176,7 @@ module Slack
           end
 
           #
-          # Retrieve members of a conversation.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   ID of the conversation to retrieve members for.
@@ -199,7 +199,7 @@ module Slack
           end
 
           #
-          # Opens or resumes a direct message or multi-person direct message.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   Resume a conversation by supplying an im or mpim's ID. Or provide the users field instead.
@@ -215,7 +215,7 @@ module Slack
           end
 
           #
-          # Renames a conversation.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   ID of conversation to rename.
@@ -231,7 +231,7 @@ module Slack
           end
 
           #
-          # Retrieve a thread of messages posted to a conversation
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   Conversation ID to fetch thread from.
@@ -263,7 +263,7 @@ module Slack
           end
 
           #
-          # Sets the purpose for a conversation.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   Conversation to set the purpose of.
@@ -279,7 +279,7 @@ module Slack
           end
 
           #
-          # Sets the topic for a conversation.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   Conversation to set the topic of.
@@ -295,7 +295,7 @@ module Slack
           end
 
           #
-          # Reverses conversation archival.
+          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
           #
           # @option options [channel] :channel
           #   ID of conversation to unarchive.