slack-ruby-client 2.4.0 → 2.5.0

data/bin/commands/conversations_canvases.rb

@@ -6,8 +6,8 @@ module Slack
     class App
       desc 'ConversationsCanvases methods.'
       command 'conversations_canvases' do |g|
-        g.desc 'Create a Channel Canvas for a channel.'
-        g.long_desc %( Create a Channel Canvas for a channel. )
+        g.desc 'Create a channel canvas for a channel'
+        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 we create the channel canvas for.'
           c.flag 'document_content', desc: 'Structure describing the type and value of the content to create.'

data/bin/commands/conversations_requestSharedInvite.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'ConversationsRequestsharedinvite methods.'
+      command 'conversations_requestSharedInvite' do |g|
+        g.desc 'Approves a request to add an external user to a channel and sends them a Slack Connect invite'
+        g.long_desc %( Approves a request to add an external user to a channel and sends them a Slack Connect invite )
+        g.command 'approve' do |c|
+          c.flag 'invite_id', desc: 'ID of the requested shared channel invite to approve.'
+          c.flag 'channel_id', desc: 'Optional channel_id to which external user will be invited to. Will override the value on the requested invite.'
+          c.flag 'is_external_limited', desc: 'Optional boolean on whether the invited team will have post-only permissions in the channel. Will override the value on the requested invite.'
+          c.flag 'message', desc: 'Object describing the text to send along with the invite. If this object is specified, both text and is_override are required properties. If is_override is set to true, text will override the original invitation message. Otherwise, text will be appended to the original invitation message. The total length of the message cannot exceed 560 characters. If is_override is set to false, the length of text and the user specified message on the invite request in total must be less than 560 characters.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.conversations_requestSharedInvite_approve(options))
+          end
+        end
+
+        g.desc 'Denies a request to invite an external user to a channel'
+        g.long_desc %( Denies a request to invite an external user to a channel )
+        g.command 'deny' do |c|
+          c.flag 'invite_id', desc: 'ID of the requested shared channel invite to deny.'
+          c.flag 'message', desc: 'Optional message explaining why the request to invite was denied.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.conversations_requestSharedInvite_deny(options))
+          end
+        end
+
+        g.desc 'Lists requests to add external users to channels with ability to filter.'
+        g.long_desc %( Lists requests to add external users to channels with ability to filter. )
+        g.command 'list' 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. See pagination for more detail."
+          c.flag 'include_approved', desc: 'When true approved invitation requests will be returned, otherwise they will be excluded.'
+          c.flag 'include_denied', desc: 'When true denied invitation requests will be returned, otherwise they will be excluded.'
+          c.flag 'include_expired', desc: 'When true expired invitation requests will be returned, otherwise they will be excluded.'
+          c.flag 'invite_ids', desc: 'An optional list of invitation ids to look up.'
+          c.flag 'limit', desc: 'The number of items to return. Must be between 1 - 1000 (inclusive).'
+          c.flag 'user_id', desc: 'Optional filter to return invitation requests for the inviting user.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.conversations_requestSharedInvite_list(options))
+          end
+        end
+      end
+    end
+  end
+end

data/bin/commands/files.rb

@@ -11,8 +11,9 @@ module Slack
         g.command 'completeUploadExternal' do |c|
           c.flag 'files', desc: 'Array of file ids and their corresponding (optional) titles.'
           c.flag 'channel_id', desc: 'Channel ID where the file will be shared. If not specified the file will be private.'
+          c.flag 'channels', desc: 'Comma-separated string of channel IDs where the file will be shared.'
           c.flag 'initial_comment', desc: 'The message text introducing the file in specified channels.'
-          c.flag 'thread_ts', desc: "Provide another message's ts value to upload this file as a reply. Never use a reply's ts value; use its parent instead."
+          c.flag 'thread_ts', desc: "Provide another message's ts value to upload this file as a reply. Never use a reply's ts value; use its parent instead. Also make sure to provide only one channel when using 'thread_ts'."
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.files_completeUploadExternal(options))
           end

data/bin/commands/usergroups.rb

@@ -10,8 +10,10 @@ module Slack
         g.long_desc %( Create a User Group. )
         g.command 'create' do |c|
           c.flag 'name', desc: 'A name for the User Group. Must be unique among User Groups.'
+          c.flag 'additional_channels', desc: 'A comma separated string of encoded channel IDs for which the User Group can custom add usergroup members too.'
           c.flag 'channels', desc: 'A comma separated string of encoded channel IDs for which the User Group uses as a default.'
           c.flag 'description', desc: 'A short description of the User Group.'
+          c.flag 'enable_section', desc: 'Configure this user group to show as a sidebar section for all group members. Note: Only relevant if group has 1 or more default channels added.'
           c.flag 'handle', desc: 'A mention handle. Must be unique among channels, users and User Groups.'
           c.flag 'include_count', desc: 'Include the number of users in each User Group.'
           c.flag 'team_id', desc: 'Encoded team id where the user group has to be created, required if org token is used.'
@@ -49,6 +51,7 @@ module Slack
           c.flag 'include_disabled', desc: 'Include disabled User Groups.'
           c.flag 'include_users', desc: 'Include the list of users for each User Group.'
           c.flag 'team_id', desc: 'encoded team id to list user groups in, required if org token is used.'
+          c.flag 'usergroup_id', desc: 'The id of the usergroup you would like to filter the results down to.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.usergroups_list(options))
           end
@@ -58,8 +61,10 @@ module Slack
         g.long_desc %( Update an existing User Group. )
         g.command 'update' do |c|
           c.flag 'usergroup', desc: 'The encoded ID of the User Group to update.'
+          c.flag 'additional_channels', desc: 'A comma separated string of encoded channel IDs for which the User Group can custom add usergroup members too.'
           c.flag 'channels', desc: 'A comma separated string of encoded channel IDs for which the User Group uses as a default.'
           c.flag 'description', desc: 'A short description of the User Group.'
+          c.flag 'enable_section', desc: 'Configure this user group to show as a sidebar section for all group members. Note: Only relevant if group has 1 or more default channels added.'
           c.flag 'handle', desc: 'A mention handle. Must be unique among channels, users and User Groups.'
           c.flag 'include_count', desc: 'Include the number of users in the User Group.'
           c.flag 'name', desc: 'A name for the User Group. Must be unique among User Groups.'

data/bin/commands/usergroups_users.rb

@@ -22,7 +22,9 @@ module Slack
         g.command 'update' do |c|
           c.flag 'usergroup', desc: 'The encoded ID of the user group to update.'
           c.flag 'users', desc: 'A comma separated string of encoded user IDs that represent the entire list of users for the user group.'
+          c.flag 'additional_channels', desc: 'A comma separated string of encoded channel IDs for which the User Group can custom add usergroup members too.'
           c.flag 'include_count', desc: 'Include the number of users in the user group.'
+          c.flag 'is_shared', desc: 'Boolean to identify if the API is getting called when a shared section is getting shared.'
           c.flag 'team_id', desc: 'encoded team id where the user group exists, required if org token is used.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.usergroups_users_update(options))

data/examples/files_upload_v2/.env.example

@@ -0,0 +1 @@
+SLACK_API_TOKEN=

data/examples/files_upload_v2/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+source 'http://rubygems.org'
+
+gem 'dotenv'
+gem 'slack-ruby-client', path: '../..'

data/examples/files_upload_v2/README.md

@@ -0,0 +1,13 @@
+Samples for using `files_upload_v2`.
+
+## Usage
+
+Create a Slack app and obtain a User OAuth Token [here](https://api.slack.com/tutorials/tracks/getting-a-token) or use the [oauth_v2](../oauth_v2) example to obtain a User OAuth Token.
+Make sure to select `files:write` and `files:read` scopes under "User Token Scopes".
+
+Create `.env` file with `SLACK_API_TOKEN` or set the `SLACK_API_TOKEN` environment variable.
+
+```
+bundle install
+bundle exec dotenv ruby files_upload_v2.rb
+```

data/examples/files_upload_v2/files_upload_v2.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+require 'slack-ruby-client'
+require 'securerandom'
+
+Slack.configure do |config|
+  config.token = ENV['SLACK_API_TOKEN']
+  raise 'Missing ENV[SLACK_API_TOKEN]!' unless config.token
+end
+
+client = Slack::Web::Client.new
+
+auth = client.auth_test
+puts "Connected to team #{auth.team} (#{auth.team_id}) as #{auth.user}."
+
+puts client.files_upload_v2(
+  filename: 'files_upload_v2.txt',
+  content: SecureRandom.hex
+).files.first.permalink_public
+
+puts client.files_upload_v2(
+  filename: 'files_upload_v2_to_general_channel.txt',
+  content: SecureRandom.hex,
+  channel: '#general'
+).files.first.permalink_public
+
+puts client.files_upload_v2(
+  filename: 'files_upload_v2_to_general_and_random_channels.txt',
+  content: SecureRandom.hex,
+  channels: ['#general', '#random']
+).files.first.permalink_public
+
+channel_id = client.conversations_id(channel: '#general')['channel']['id']
+puts client.files_upload_v2(
+  filename: 'files_upload_v2_to_general_by_id.txt',
+  content: SecureRandom.hex,
+  channel_id: channel_id
+).files.first.permalink_public

data/examples/oauth_v2/.env.example

@@ -0,0 +1,4 @@
+SLACK_CLIENT_ID=
+SLACK_CLIENT_SECRET=
+REDIRECT_URI=https://...ngrok-free.app
+SCOPE=files:read,files:write,files:write:user

data/examples/oauth_v2/Gemfile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+source 'http://rubygems.org'
+
+gem 'activesupport'
+gem 'dotenv'
+gem 'slack-ruby-client', path: '../..'
+gem 'webrick'

data/examples/oauth_v2/README.md

@@ -0,0 +1,33 @@
+Obtain a user OAuth token from Slack.
+
+Create a Slack app [here](https://api.slack.com/tutorials/tracks/getting-a-token). 
+
+The new app has a pre-configured User OAuth Token which you can use for most of the examples.
+However you may want to obtain a token for a different user, which can be accomplished as follows.
+
+To test locally use [ngrok](https://ngrok.com/) to expose your local server to the internet. 
+
+```sh
+ngrok http 4242
+```
+
+Add the ngrok URL to the app's "Redirect URLs" under "OAuth & Permissions" in the app's settings.
+
+Create a `.env` file with the following:
+
+```
+SLACK_CLIENT_ID=[App Client ID]
+SLACK_CLIENT_SECRET=[App Client Secret]
+REDIRECT_URI=[Your ngrok URL, e.g. https://...ngrok-free.app]
+SCOPE=[Bot User OAuth Scopes Requested]
+USER_SCOPE=[User OAuth Token Scopes Requested]
+```
+
+Run the example.
+
+```sh
+bundle install
+bundle exec dotenv ruby oauth_v2.rb 
+```
+
+A browser window will open to complete the OAuth flow.

data/examples/oauth_v2/oauth_v2.rb

@@ -0,0 +1,60 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'dotenv/load'
+require 'webrick'
+require 'slack-ruby-client'
+require 'active_support'
+require 'active_support/core_ext/object/to_query'
+
+server = WEBrick::HTTPServer.new(Port: ENV['PORT'] || 4242)
+
+trap 'INT' do
+  server.shutdown
+end
+
+server.mount_proc '/' do |req, res|
+  client = Slack::Web::Client.new
+
+  response = client.oauth_v2_access(
+    req.query.merge(
+      client_id: ENV['SLACK_CLIENT_ID'],
+      client_secret: ENV['SLACK_CLIENT_SECRET'],
+      grant_type: 'authorization_code'
+    )
+  )
+
+  pp response
+
+  res.body = %(
+<html>
+  <body>
+    <ul>
+      <li>bot access_token: #{response.access_token}</li>
+      <li>token_type: #{response.token_type}</li>
+      <li>app_id: #{response.app_id}</li>
+      <li>scope: #{response.scope}</li>
+      <li>user: #{response.authed_user.id}</li>
+      <li>user access token: #{response.authed_user.access_token}</li>
+    </ul>
+  <body>
+</html>
+  )
+
+  pp Slack::Web::Client.new(token: response.authed_user.access_token || response.access_token).auth_test
+
+  server.shutdown
+end
+
+query = {
+  client_id: ENV['SLACK_CLIENT_ID'],
+  redirect_uri: ENV['REDIRECT_URI'],
+  scope: ENV['SCOPE'],
+  user_scope: ENV['USER_SCOPE']
+}
+
+url = "https://slack.com/oauth/v2/authorize?#{query.to_query}"
+puts "Opening browser at #{url}."
+system 'open', url
+
+server.start

data/lib/slack/messages/formatting.rb

@@ -75,7 +75,7 @@ module Slack
         #
         def markdown(text)
           text
-            .gsub(/(?<!\*)\*([^*]+)\*(?!\*)/, '_\1_') # italic
+            .gsub(/(?<!\*)\*([^*\n]+)\*(?!\*)/, '_\1_') # italic
             .gsub(/\*\*\*(.*?)\*\*\*/, '*_\1_*') # bold & italic
             .gsub(/\*\*(.*?)\*\*/, '*\1*') # bold
             .gsub(/~~(.*?)~~/, '~\1~') # strikethrough

data/lib/slack/version.rb

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

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

@@ -191,6 +191,25 @@ module Slack
             post('admin.conversations.invite', options)
           end
 
+          #
+          # Link a Salesforce record to a channel
+          #
+          # @option options [channel] :channel
+          #   Channel ID for Slack channel that will be linked to a Salesforce record.
+          # @option options [string] :record_id
+          #   Salesforce record ID (15 or 18 digit accepted). See here for how to look up record ID.
+          # @option options [string] :salesforce_org_id
+          #   Salesforce org ID (15 or 18 digit accepted). See here for how to look up Salesforce org ID.
+          # @see https://api.slack.com/methods/admin.conversations.linkObjects
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.conversations/admin.conversations.linkObjects.json
+          def admin_conversations_linkObjects(options = {})
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :record_id missing' if options[:record_id].nil?
+            raise ArgumentError, 'Required arguments :salesforce_org_id missing' if options[:salesforce_org_id].nil?
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
+            post('admin.conversations.linkObjects', options)
+          end
+
           #
           # Returns channels on the given team using the filters.
           #
@@ -338,6 +357,22 @@ module Slack
             raise ArgumentError, 'Required arguments :channel_id missing' if options[:channel_id].nil?
             post('admin.conversations.unarchive', options)
           end
+
+          #
+          # Unlink a Salesforce record from a channel
+          #
+          # @option options [channel] :channel
+          #   Channel ID for Slack channel that will be unlinked from the Salesforce record.
+          # @option options [string] :new_name
+          #   Channel name you would like to give to the channel that is being unlinked from the Salesforce record.
+          # @see https://api.slack.com/methods/admin.conversations.unlinkObjects
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.conversations/admin.conversations.unlinkObjects.json
+          def admin_conversations_unlinkObjects(options = {})
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :new_name missing' if options[:new_name].nil?
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
+            post('admin.conversations.unlinkObjects', options)
+          end
         end
       end
     end

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

@@ -35,13 +35,12 @@ module Slack
           #
           # @option options [integer] :session_id
           #   ID of the session to invalidate.
-          # @option options [string] :team_id
-          #   ID of the workspace that the session belongs to.
+          # @option options [Object] :user_id
+          #   ID of the user that the session belongs to.
           # @see https://api.slack.com/methods/admin.users.session.invalidate
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users.session/admin.users.session.invalidate.json
           def admin_users_session_invalidate(options = {})
             raise ArgumentError, 'Required arguments :session_id missing' if options[:session_id].nil?
-            raise ArgumentError, 'Required arguments :team_id missing' if options[:team_id].nil?
             post('admin.users.session.invalidate', options)
           end
 

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

@@ -12,7 +12,7 @@ module Slack
           # @option options [Object] :app_id
           #   The parent app ID for which to return workflows.
           # @option options [array] :collaborator_ids
-          #   Only include workflows where the provided user IDs are a manager/collaborator of that workflow.
+          #   Only include workflows where all of the provided user IDs are a manager/collaborator of that workflow.
           # @option options [string] :cursor
           #   Set cursor to next_cursor returned by the previous call to list items in the next page.
           # @option options [boolean] :is_sales_elevate
@@ -23,6 +23,8 @@ module Slack
           #   Only include workflows with no collaborators in the result; default is false.
           # @option options [integer] :num_trigger_ids
           #   Number of trigger IDs to fetch for each workflow; default is 10.
+          # @option options [enum] :publish_status
+          #   Filter workflows by their published status.
           # @option options [string] :query
           #   A search query to filter for workflow name or description.
           # @option options [enum] :sort
@@ -31,6 +33,8 @@ module Slack
           #   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).
           # @option options [enum] :source
           #   Source of workflow creation, either from code or workflow builder.
+          # @option options [array] :step_function_ids
+          #   Only include workflows that use all of the provided step function ids.
           # @option options [string] :trigger_type_id
           #   Only include workflows with this trigger type.
           # @see https://api.slack.com/methods/admin.workflows.search

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

@@ -7,7 +7,7 @@ module Slack
       module Endpoints
         module AdminWorkflowsTriggersTypesPermissions
           #
-          # list the permissions for using each trigger type in workflow builder
+          # list the permissions for using each trigger type
           #
           # @option options [array] :trigger_type_ids
           #   The trigger types IDs for which to get the permissions.
@@ -19,7 +19,7 @@ module Slack
           end
 
           #
-          # Set the permissions for using a trigger type in workflow builder
+          # Set the permissions for using a trigger type
           #
           # @option options [Object] :id
           #   The trigger type ID for which to set the permissions.

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

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AssistantThreads
+          #
+          # Set the status for an AI assistant thread.
+          #
+          # @option options [Object] :channel_id
+          #   Channel ID containing the assistant thread.
+          # @option options [string] :status
+          #   Status of the specified bot user, e.g. 'is thinking...'.
+          # @option options [string] :thread_ts
+          #   Message timestamp of the thread of where to set the status.
+          # @see https://api.slack.com/methods/assistant.threads.setStatus
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/assistant.threads/assistant.threads.setStatus.json
+          def assistant_threads_setStatus(options = {})
+            raise ArgumentError, 'Required arguments :channel_id missing' if options[:channel_id].nil?
+            raise ArgumentError, 'Required arguments :status missing' if options[:status].nil?
+            raise ArgumentError, 'Required arguments :thread_ts missing' if options[:thread_ts].nil?
+            post('assistant.threads.setStatus', options)
+          end
+
+          #
+          # Set suggested prompts for the given assistant thread
+          #
+          # @option options [Object] :channel_id
+          #   Channel ID containing the assistant thread.
+          # @option options [Object] :prompts
+          #   Each prompt should be supplied with its title and message attribute.
+          # @option options [string] :thread_ts
+          #   Message timestamp of the thread to set suggested prompts for.
+          # @option options [string] :title
+          #   Title for the list of provided prompts. For example: Suggested Prompts, Related Questions.
+          # @see https://api.slack.com/methods/assistant.threads.setSuggestedPrompts
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/assistant.threads/assistant.threads.setSuggestedPrompts.json
+          def assistant_threads_setSuggestedPrompts(options = {})
+            raise ArgumentError, 'Required arguments :channel_id missing' if options[:channel_id].nil?
+            raise ArgumentError, 'Required arguments :prompts missing' if options[:prompts].nil?
+            raise ArgumentError, 'Required arguments :thread_ts missing' if options[:thread_ts].nil?
+            post('assistant.threads.setSuggestedPrompts', options)
+          end
+
+          #
+          # Set the title for the given assistant thread
+          #
+          # @option options [Object] :channel_id
+          #   Channel ID containing the assistant thread.
+          # @option options [string] :thread_ts
+          #   Message timestamp of the thread to set suggested prompts for.
+          # @option options [string] :title
+          #   The title to use for the thread.
+          # @see https://api.slack.com/methods/assistant.threads.setTitle
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/assistant.threads/assistant.threads.setTitle.json
+          def assistant_threads_setTitle(options = {})
+            raise ArgumentError, 'Required arguments :channel_id missing' if options[:channel_id].nil?
+            raise ArgumentError, 'Required arguments :thread_ts missing' if options[:thread_ts].nil?
+            raise ArgumentError, 'Required arguments :title missing' if options[:title].nil?
+            post('assistant.threads.setTitle', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -15,6 +15,8 @@ module Slack
           #   Title for the bookmark.
           # @option options [string] :type
           #   Type of the bookmark i.e link.
+          # @option options [enum] :access_level
+          #   The level that we are setting the file's permission to (read or write).
           # @option options [string] :emoji
           #   Emoji tag to apply to the link.
           # @option options [string] :entity_id

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

@@ -7,7 +7,7 @@ module Slack
       module Endpoints
         module Canvases
           #
-          # Create Canvas for a user.
+          # Create canvas for a user
           #
           # @option options [Object] :document_content
           #   Structure describing the type and value of the content to create.
@@ -20,7 +20,7 @@ module Slack
           end
 
           #
-          # Deletes a canvas.
+          # Deletes a canvas
           #
           # @option options [Object] :canvas_id
           #   Encoded ID of the canvas.

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

@@ -25,14 +25,14 @@ module Slack
           #
           # Sets the access level to a canvas for specified entities
           #
-          # @option options [Object] :access_level
-          #   Desired level of access (e.g. read, write).
+          # @option options [enum] :access_level
+          #   Desired level of access.
           # @option options [Object] :canvas_id
           #   Encoded ID of the canvas.
           # @option options [array] :channel_ids
-          #   List of channels you wish to update access for.
+          #   List of channels you wish to update access for. Can only be used if user_ids is not provided.
           # @option options [array] :user_ids
-          #   List of users you wish to update access for.
+          #   List of users you wish to update access for. Can only be used if channel_ids is not provided.
           # @see https://api.slack.com/methods/canvases.access.set
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/canvases.access/canvases.access.set.json
           def canvases_access_set(options = {})

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

@@ -112,6 +112,8 @@ module Slack
           #   URL to an image to use as the icon for this message.
           # @option options [boolean] :link_names
           #   Find and link channel names and usernames.
+          # @option options [string] :markdown_text
+          #   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.
           # @option options [string] :parse
           #   Change how messages are treated. Defaults to none. See below.
           # @option options [string] :thread_ts
@@ -133,7 +135,7 @@ module Slack
           # Sends a message to a 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.
+          #   An encoded ID or channel name that represents a channel, private group, or IM channel to send the message to. See below for more details.
           # @option options [string] :attachments
           #   A JSON-based array of structured attachments, presented as a URL-encoded string.
           # @option options [blocks[] as string] :blocks
@@ -141,13 +143,15 @@ module Slack
           # @option options [string] :text
           #   How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.
           # @option options [boolean] :as_user
-          #   (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.
+          #   (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.
           # @option options [string] :icon_emoji
           #   Emoji to use as the icon for this message. Overrides icon_url.
           # @option options [string] :icon_url
           #   URL to an image to use as the icon for this message.
           # @option options [boolean] :link_names
           #   Find and link user groups. No longer supports linking individual users; use syntax shown in Mentioning Users instead.
+          # @option options [string] :markdown_text
+          #   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.
           # @option options [string] :metadata
           #   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.
           # @option options [boolean] :mrkdwn
@@ -169,6 +173,7 @@ module Slack
           def chat_postMessage(options = {})
             raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             raise ArgumentError, 'At least one of :attachments, :blocks, :text is required' if options[:attachments].nil? && options[:blocks].nil? && options[:text].nil?
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             options = encode_options_as_json(options, %i[attachments blocks metadata])
             post('chat.postMessage', options)
           end
@@ -190,6 +195,8 @@ module Slack
           #   Set to true to post the message as the authed user, instead of as a bot. Defaults to false. Cannot be used by new Slack apps. See chat.postMessage.
           # @option options [boolean] :link_names
           #   Find and link user groups. No longer supports linking individual users; use syntax shown in Mentioning Users instead.
+          # @option options [string] :markdown_text
+          #   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.
           # @option options [string] :metadata
           #   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.
           # @option options [enum] :parse
@@ -248,7 +255,7 @@ module Slack
           # Updates a message.
           #
           # @option options [channel] :channel
-          #   Channel containing the message to be updated.
+          #   Channel containing the message to be updated. For direct messages, ensure that this value is a DM ID (starts with D) instead of a User ID (starts with either U or W).
           # @option options [timestamp] :ts
           #   Timestamp of the message to be updated.
           # @option options [string] :attachments
@@ -263,6 +270,8 @@ module Slack
           #   Array of new file ids that will be sent with this message.
           # @option options [boolean] :link_names
           #   Find and link channel names and usernames. Defaults to none. If you do not specify a value for this field, the original value set for the message will be overwritten with the default, none.
+          # @option options [string] :markdown_text
+          #   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.
           # @option options [string] :metadata
           #   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.
           # @option options [string] :parse

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

@@ -172,7 +172,7 @@ module Slack
           # @option options [array] :emails
           #   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.
           # @option options [boolean] :external_limited
-          #   Optional boolean on whether invite is to a external limited member. Defaults to true.
+          #   Optional boolean on whether invite is to an external limited member. Defaults to true.
           # @option options [array] :user_ids
           #   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.
           # @see https://api.slack.com/methods/conversations.inviteShared
@@ -378,12 +378,12 @@ module Slack
           end
 
           #
-          # Sets the purpose for a conversation.
+          # Sets the channel description.
           #
           # @option options [channel] :channel
-          #   Conversation to set the purpose of.
+          #   Channel to set the description of.
           # @option options [string] :purpose
-          #   A new, specialer purpose.
+          #   The description.
           # @see https://api.slack.com/methods/conversations.setPurpose
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.setPurpose.json
           def conversations_setPurpose(options = {})

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

@@ -7,7 +7,7 @@ module Slack
       module Endpoints
         module ConversationsCanvases
           #
-          # Create a Channel Canvas for a channel.
+          # Create a channel canvas for a channel
           #
           # @option options [string] :channel_id
           #   Channel ID of the channel we create the channel canvas for.