slack-ruby-client 0.14.6 → 1.0.0

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

@@ -6,33 +6,6 @@ module Slack
     module Api
       module Endpoints
         module Channels
-          #
-          # Archives a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to archive.
-          # @see https://api.slack.com/methods/channels.archive
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.archive.json
-          def channels_archive(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.archive', options)
-          end
-
-          #
-          # Creates a channel.
-          #
-          # @option options [Object] :name
-          #   Name of channel to create.
-          # @option options [Object] :validate
-          #   Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.
-          # @see https://api.slack.com/methods/channels.create
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.create.json
-          def channels_create(options = {})
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
-            post('channels.create', options)
-          end
-
           #
           # Delete a channel (undocumented)
           #
@@ -41,227 +14,10 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/undocumented/channels/channels.delete.json
           def channels_delete(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             logger.warn('The channels.delete method is undocumented.')
             post('channels.delete', options)
           end
-
-          #
-          # Fetches history of messages and events from a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to fetch history for.
-          # @option options [Object] :inclusive
-          #   Include messages with latest or oldest timestamp in results.
-          # @option options [timestamp] :latest
-          #   End of time range of messages to include in results.
-          # @option options [timestamp] :oldest
-          #   Start of time range of messages to include in results.
-          # @option options [Object] :unreads
-          #   Include unread_count_display in the output?.
-          # @see https://api.slack.com/methods/channels.history
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.history.json
-          def channels_history(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.history', options)
-          end
-
-          #
-          # Gets information about a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to get info on.
-          # @option options [Object] :include_locale
-          #   Set this to true to receive the locale for this channel. Defaults to false.
-          # @see https://api.slack.com/methods/channels.info
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.info.json
-          def channels_info(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.info', options)
-          end
-
-          #
-          # Invites a user to a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to invite user to.
-          # @option options [user] :user
-          #   User to invite to channel.
-          # @see https://api.slack.com/methods/channels.invite
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.invite.json
-          def channels_invite(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            options = options.merge(user: users_id(options)['user']['id']) if options[:user]
-            post('channels.invite', options)
-          end
-
-          #
-          # Joins a channel, creating it if needed.
-          #
-          # @option options [Object] :name
-          #   Name of channel to join.
-          # @option options [Object] :validate
-          #   Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.
-          # @see https://api.slack.com/methods/channels.join
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.join.json
-          def channels_join(options = {})
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
-            post('channels.join', options)
-          end
-
-          #
-          # Removes a user from a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to remove user from.
-          # @option options [user] :user
-          #   User to remove from channel.
-          # @see https://api.slack.com/methods/channels.kick
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.kick.json
-          def channels_kick(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            options = options.merge(user: users_id(options)['user']['id']) if options[:user]
-            post('channels.kick', options)
-          end
-
-          #
-          # Leaves a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to leave.
-          # @see https://api.slack.com/methods/channels.leave
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.leave.json
-          def channels_leave(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.leave', options)
-          end
-
-          #
-          # Lists all channels in a Slack team.
-          #
-          # @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.
-          # @option options [Object] :exclude_archived
-          #   Exclude archived channels from the list.
-          # @option options [Object] :exclude_members
-          #   Exclude the members collection from each channel.
-          # @option options [Object] :limit
-          #   The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the users list hasn't been reached.
-          # @see https://api.slack.com/methods/channels.list
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.list.json
-          def channels_list(options = {})
-            if block_given?
-              Pagination::Cursor.new(self, :channels_list, options).each do |page|
-                yield page
-              end
-            else
-              post('channels.list', options)
-            end
-          end
-
-          #
-          # Sets the read cursor in a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to set reading cursor in.
-          # @option options [timestamp] :ts
-          #   Timestamp of the most recently seen message.
-          # @see https://api.slack.com/methods/channels.mark
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.mark.json
-          def channels_mark(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.mark', options)
-          end
-
-          #
-          # Renames a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to rename.
-          # @option options [Object] :name
-          #   New name for channel.
-          # @option options [Object] :validate
-          #   Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.
-          # @see https://api.slack.com/methods/channels.rename
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.rename.json
-          def channels_rename(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.rename', options)
-          end
-
-          #
-          # Retrieve a thread of messages posted to a channel
-          #
-          # @option options [channel] :channel
-          #   Channel to fetch thread from.
-          # @option options [Object] :thread_ts
-          #   Unique identifier of a thread's parent message.
-          # @see https://api.slack.com/methods/channels.replies
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.replies.json
-          def channels_replies(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :thread_ts missing') if options[:thread_ts].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.replies', options)
-          end
-
-          #
-          # Sets the purpose for a 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 = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :purpose missing') if options[:purpose].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.setPurpose', options)
-          end
-
-          #
-          # Sets the topic for a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to set the topic of.
-          # @option options [Object] :topic
-          #   The new topic.
-          # @see https://api.slack.com/methods/channels.setTopic
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.setTopic.json
-          def channels_setTopic(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :topic missing') if options[:topic].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.setTopic', options)
-          end
-
-          #
-          # Unarchives a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to unarchive.
-          # @see https://api.slack.com/methods/channels.unarchive
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.unarchive.json
-          def channels_unarchive(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.unarchive', options)
-          end
         end
       end
     end

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

@@ -19,7 +19,7 @@ module Slack
           def chat_command(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :command missing') if options[:command].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             logger.warn('The chat.command method is undocumented.')
             post('chat.command', options)
           end
@@ -31,14 +31,14 @@ module Slack
           #   Channel containing the message to be deleted.
           # @option options [timestamp] :ts
           #   Timestamp of the message to be deleted.
-          # @option options [Object] :as_user
+          # @option options [boolean] :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.delete
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.delete.json
           def chat_delete(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('chat.delete', options)
           end
 
@@ -47,16 +47,16 @@ module Slack
           #
           # @option options [channel] :channel
           #   The channel the scheduled_message is posting to.
-          # @option options [Object] :scheduled_message_id
+          # @option options [string] :scheduled_message_id
           #   scheduled_message_id returned from call to chat.scheduleMessage.
-          # @option options [Object] :as_user
+          # @option options [boolean] :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]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('chat.deleteScheduledMessage', options)
           end
 
@@ -65,14 +65,14 @@ module Slack
           #
           # @option options [channel] :channel
           #   The ID of the conversation or channel containing the message.
-          # @option options [Object] :message_ts
+          # @option options [string] :message_ts
           #   A message's ts value, uniquely identifying it within a channel.
           # @see https://api.slack.com/methods/chat.getPermalink
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.getPermalink.json
           def chat_getPermalink(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :message_ts missing') if options[:message_ts].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('chat.getPermalink', options)
           end
 
@@ -81,7 +81,7 @@ module Slack
           #
           # @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.
-          # @option options [Object] :text
+          # @option options [string] :text
           #   Text of the message to send.
           # @see https://api.slack.com/methods/chat.meMessage
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.meMessage.json
@@ -94,29 +94,29 @@ module Slack
           #
           # Sends an ephemeral message to a user in a channel.
           #
-          # @option options [Object] :attachments
-          #   A JSON-based array of structured attachments, presented as a URL-encoded string.
           # @option options [channel] :channel
           #   Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name.
-          # @option options [Object] :text
+          # @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 [user] :user
           #   id of the user who will receive the ephemeral message. The user should be in the channel specified by the channel argument.
-          # @option options [Object] :as_user
+          # @option options [boolean] :as_user
           #   Pass true to post the message as the authed user. Defaults to true if the chat:write:bot scope is not included. Otherwise, defaults to false.
-          # @option options [Object] :blocks
+          # @option options [string] :attachments
+          #   A JSON-based array of structured attachments, presented as a URL-encoded string.
+          # @option options [blocks[] as string] :blocks
           #   A JSON-based array of structured blocks, presented as a URL-encoded string.
-          # @option options [Object] :icon_emoji
+          # @option options [string] :icon_emoji
           #   Emoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
-          # @option options [Object] :icon_url
+          # @option options [string] :icon_url
           #   URL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
-          # @option options [Object] :link_names
+          # @option options [boolean] :link_names
           #   Find and link channel names and usernames.
-          # @option options [Object] :parse
+          # @option options [string] :parse
           #   Change how messages are treated. Defaults to none. See below.
-          # @option options [Object] :thread_ts
+          # @option options [string] :thread_ts
           #   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.
-          # @option options [Object] :username
+          # @option options [string] :username
           #   Set your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
           # @see https://api.slack.com/methods/chat.postEphemeral
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postEphemeral.json
@@ -145,33 +145,33 @@ module Slack
           #
           # @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.
-          # @option options [Object] :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 [Object] :as_user
-          #   Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below. This argument may not be used with newer bot tokens.
-          # @option options [Object] :attachments
+          # @option options [string] :attachments
           #   A JSON-based array of structured attachments, presented as a URL-encoded string.
-          # @option options [Object] :blocks
+          # @option options [blocks[] as string] :blocks
           #   A JSON-based array of structured blocks, presented as a URL-encoded string.
-          # @option options [Object] :icon_emoji
-          #   Emoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below. This argument may not be used with newer bot tokens.
-          # @option options [Object] :icon_url
-          #   URL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below. This argument may not be used with newer bot tokens.
-          # @option options [Object] :link_names
+          # @option options [string] :text
+          #   The formatted text of the message to be published. If blocks are included, this will become the fallback text used in notifications.
+          # @option options [boolean] :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 [string] :icon_emoji
+          #   Emoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
+          # @option options [string] :icon_url
+          #   URL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
+          # @option options [boolean] :link_names
           #   Find and link channel names and usernames.
-          # @option options [Object] :mrkdwn
+          # @option options [boolean] :mrkdwn
           #   Disable Slack markup parsing by setting to false. Enabled by default.
-          # @option options [Object] :parse
+          # @option options [string] :parse
           #   Change how messages are treated. Defaults to none. See below.
-          # @option options [Object] :reply_broadcast
+          # @option options [boolean] :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
+          # @option options [string] :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
+          # @option options [boolean] :unfurl_links
           #   Pass true to enable unfurling of primarily text-based content.
-          # @option options [Object] :unfurl_media
+          # @option options [boolean] :unfurl_media
           #   Pass false to disable unfurling of media content.
-          # @option options [Object] :username
+          # @option options [string] :username
           #   Set your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
           # @see https://api.slack.com/methods/chat.postMessage
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postMessage.json
@@ -198,27 +198,27 @@ module Slack
           #
           # @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
+          # @option options [integer] :post_at
           #   Unix EPOCH timestamp of time in future to send the message.
-          # @option options [Object] :text
+          # @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 [Object] :as_user
+          # @option options [boolean] :as_user
           #   Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See chat.postMessage.
-          # @option options [Object] :attachments
+          # @option options [string] :attachments
           #   A JSON-based array of structured attachments, presented as a URL-encoded string.
-          # @option options [Object] :blocks
+          # @option options [blocks[] as string] :blocks
           #   A JSON-based array of structured blocks, presented as a URL-encoded string.
-          # @option options [Object] :link_names
+          # @option options [boolean] :link_names
           #   Find and link channel names and usernames.
-          # @option options [Object] :parse
+          # @option options [string] :parse
           #   Change how messages are treated. Defaults to none. See chat.postMessage.
-          # @option options [Object] :reply_broadcast
+          # @option options [boolean] :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
+          # @option options [string] :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
+          # @option options [boolean] :unfurl_links
           #   Pass true to enable unfurling of primarily text-based content.
-          # @option options [Object] :unfurl_media
+          # @option options [boolean] :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
@@ -233,14 +233,20 @@ module Slack
           # Provide custom unfurl behavior for user-posted URLs
           #
           # @option options [channel] :channel
-          #   Channel ID of the message.
+          #   Channel ID of the message. Both channel and ts must be provided together, or unfurl_id and source must be provided together.
           # @option options [timestamp] :ts
           #   Timestamp of the message to add unfurl behavior to.
-          # @option options [Object] :unfurls
+          # @option options [string] :unfurls
           #   URL-encoded JSON map with keys set to URLs featured in the the message, pointing to their unfurl blocks or message attachments.
+          # @option options [string] :source
+          #   The source of the link to unfurl. The source may either be composer, when the link is inside the message composer, or conversations_history, when the link has been posted to a conversation.
+          # @option options [string] :unfurl_id
+          #   The ID of the link to unfurl. Both unfurl_id and source must be provided together, or channel and ts must be provided together.
+          # @option options [Object] :user_auth_blocks
+          #   Provide a JSON based array of structured blocks presented as URL-encoded 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_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
+          #   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.
+          # @option options [boolean] :user_auth_required
           #   Set to true or 1 to indicate the user must install your Slack app to trigger unfurls for this domain.
           # @option options [Object] :user_auth_url
           #   Send users to this custom URL where they will complete authentication in your app to fully trigger unfurling. Value should be properly URL-encoded.
@@ -250,7 +256,7 @@ module Slack
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
             throw ArgumentError.new('Required arguments :unfurls missing') if options[:unfurls].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('chat.unfurl', options)
           end
 
@@ -259,27 +265,31 @@ module Slack
           #
           # @option options [channel] :channel
           #   Channel containing the message to be updated.
-          # @option options [Object] :text
-          #   New text for the message, using the default formatting rules. It's not required when presenting attachments.
           # @option options [timestamp] :ts
           #   Timestamp of the message to be updated.
-          # @option options [Object] :as_user
+          # @option options [boolean] :as_user
           #   Pass true to update the message as the authed user. Bot users in this context are considered authed users.
-          # @option options [Object] :attachments
-          #   A JSON-based array of structured attachments, presented as a URL-encoded string. This field is required when not presenting text.
-          # @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. Defaults to none. See below.
-          # @option options [Object] :parse
-          #   Change how messages are treated. Defaults to client, unlike chat.postMessage. See below.
+          # @option options [string] :attachments
+          #   A JSON-based array of structured attachments, presented as a URL-encoded string. This field is required when not presenting text. If you don't include this field, the message's previous attachments will be retained. To remove previous attachments, include an empty array for this field.
+          # @option options [blocks[] as string] :blocks
+          #   A JSON-based array of structured blocks, presented as a URL-encoded string. If you don't include this field, the message's previous blocks will be retained. To remove previous blocks, include an empty array for this field.
+          # @option options [array] :file_ids
+          #   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] :parse
+          #   Change how messages are treated. Defaults to client, unlike chat.postMessage. Accepts either none or full. If you do not specify a value for this field, the original value set for the message will be overwritten with the default, client.
+          # @option options [boolean] :reply_broadcast
+          #   Broadcast an existing thread reply to make it visible to everyone in the channel or conversation.
+          # @option options [string] :text
+          #   New text for the message, using the default formatting rules. It's not required when presenting blocks or attachments.
           # @see https://api.slack.com/methods/chat.update
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.update.json
           def chat_update(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :text, :attachments or :blocks missing') if options[:text].nil? && options[:attachments].nil? && options[:blocks].nil?
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             # attachments must be passed as an encoded JSON string
             if options.key?(:attachments)
               attachments = options[:attachments]

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

@@ -11,18 +11,20 @@ module Slack
           #
           # @option options [channel] :channel
           #   The channel of the scheduled messages.
-          # @option options [Object] :cursor
+          # @option options [string] :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
+          # @option options [integer] :limit
           #   Maximum number of original entries to return.
           # @option options [timestamp] :oldest
           #   A UNIX timestamp of the oldest value in the time range.
+          # @option options [string] :team_id
+          #   encoded team id to list channels in, required if org token is used.
           # @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]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             if block_given?
               Pagination::Cursor.new(self, :chat_scheduledMessages_list, options).each do |page|
                 yield page