slack-ruby-client 0.14.5 → 0.17.0

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
@@ -38,7 +38,7 @@ module Slack
           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
 
@@ -56,7 +56,7 @@ module Slack
           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
 
@@ -72,7 +72,7 @@ module Slack
           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
 
@@ -99,7 +99,7 @@ module Slack
           # @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
-          #   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.
+          #   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
@@ -145,14 +145,14 @@ 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
-          #   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] :draft_id
+          #   The id of the draft associated with the message.
           # @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.
           # @option options [Object] :icon_url
@@ -165,6 +165,8 @@ module Slack
           #   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] :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] :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
@@ -201,9 +203,9 @@ module Slack
           # @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.
+          #   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.
+          #   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
           #   A JSON-based array of structured attachments, presented as a URL-encoded string.
           # @option options [Object] :blocks
@@ -211,7 +213,7 @@ module Slack
           # @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.
+          #   Change how messages are treated. Defaults to none. See chat.postMessage.
           # @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
@@ -238,8 +240,10 @@ module Slack
           #   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 blocks or message attachments.
+          # @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.
+          #   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 [Object] :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
@@ -250,7 +254,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 +263,27 @@ 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
           #   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.
+          #   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 [Object] :blocks
-          #   A JSON-based array of structured blocks, presented as a URL-encoded string.
+          #   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 [Object] :link_names
-          #   Find and link channel names and usernames. Defaults to none. See below.
+          #   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 [Object] :parse
-          #   Change how messages are treated. Defaults to client, unlike chat.postMessage. See below.
+          #   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 [Object] :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

@@ -19,10 +19,12 @@ module Slack
           #   Maximum number of original entries to return.
           # @option options [timestamp] :oldest
           #   A UNIX timestamp of the oldest value in the time range.
+          # @option options [Object] :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

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

@@ -15,7 +15,7 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.archive.json
           def conversations_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]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.archive', options)
           end
 
@@ -28,7 +28,7 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.close.json
           def conversations_close(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]
             post('conversations.close', options)
           end
 
@@ -39,8 +39,8 @@ module Slack
           #   Name of the public or private channel to create.
           # @option options [Object] :is_private
           #   Create a private channel instead of a public one.
-          # @option options [Object] :user_ids
-          #   Required for workspace apps. A list of between 1 and 30 human users that will be added to the newly-created conversation. This argument has no effect when used by classic Slack apps.
+          # @option options [Object] :team_id
+          #   encoded team id to create the channel in, required if org token is used.
           # @see https://api.slack.com/methods/conversations.create
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.create.json
           def conversations_create(options = {})
@@ -67,7 +67,7 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.history.json
           def conversations_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]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             if block_given?
               Pagination::Cursor.new(self, :conversations_history, options).each do |page|
                 yield page
@@ -90,7 +90,7 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.info.json
           def conversations_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]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.info', options)
           end
 
@@ -100,13 +100,13 @@ module Slack
           # @option options [channel] :channel
           #   The ID of the public or private channel to invite user(s) to.
           # @option options [Object] :users
-          #   A comma separated list of user IDs. Up to 30 users may be listed.
+          #   A comma separated list of user IDs. Up to 1000 users may be listed.
           # @see https://api.slack.com/methods/conversations.invite
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.invite.json
           def conversations_invite(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :users missing') if options[:users].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('conversations.invite', options)
           end
 
@@ -119,7 +119,7 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.join.json
           def conversations_join(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]
             post('conversations.join', options)
           end
 
@@ -135,7 +135,7 @@ module Slack
           def conversations_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(channel: conversations_id(options)['channel']['id']) if options[:channel]
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             post('conversations.kick', options)
           end
@@ -149,7 +149,7 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.leave.json
           def conversations_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]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.leave', options)
           end
 
@@ -162,6 +162,8 @@ module Slack
           #   Set to true to exclude archived channels from the list.
           # @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 list hasn't been reached. Must be an integer no larger than 1000.
+          # @option options [Object] :team_id
+          #   encoded team id to list channels in, required if token belongs to org-wide app.
           # @option options [Object] :types
           #   Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im.
           # @see https://api.slack.com/methods/conversations.list
@@ -176,6 +178,22 @@ module Slack
             end
           end
 
+          #
+          # Sets the read cursor in a channel.
+          #
+          # @option options [channel] :channel
+          #   Channel or conversation to set the read cursor for.
+          # @option options [timestamp] :ts
+          #   Unique identifier of message you want marked as most recently seen in this conversation.
+          # @see https://api.slack.com/methods/conversations.mark
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.mark.json
+          def conversations_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: conversations_id(options)['channel']['id']) if options[:channel]
+            post('conversations.mark', options)
+          end
+
           #
           # Retrieve members of a conversation.
           #
@@ -189,7 +207,7 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.members.json
           def conversations_members(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]
             if block_given?
               Pagination::Cursor.new(self, :conversations_members, options).each do |page|
                 yield page
@@ -211,7 +229,7 @@ module Slack
           # @see https://api.slack.com/methods/conversations.open
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.open.json
           def conversations_open(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]
             post('conversations.open', options)
           end
 
@@ -227,7 +245,7 @@ module Slack
           def conversations_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]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.rename', options)
           end
 
@@ -237,7 +255,7 @@ module Slack
           # @option options [channel] :channel
           #   Conversation ID to fetch thread from.
           # @option options [timestamp] :ts
-          #   Unique identifier of a thread's parent message.
+          #   Unique identifier of either a thread's parent message or a message in the thread. ts must be the timestamp of an existing message with 0 or more replies. If there are no replies then just the single message referenced by ts will return - it is just an ordinary, unthreaded message.
           # @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] :inclusive
@@ -253,7 +271,7 @@ module Slack
           def conversations_replies(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]
             if block_given?
               Pagination::Cursor.new(self, :conversations_replies, options).each do |page|
                 yield page
@@ -275,7 +293,7 @@ module Slack
           def conversations_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]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.setPurpose', options)
           end
 
@@ -291,7 +309,7 @@ module Slack
           def conversations_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]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.setTopic', options)
           end
 
@@ -304,7 +322,7 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.unarchive.json
           def conversations_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]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.unarchive', options)
           end
         end

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

@@ -27,6 +27,8 @@ module Slack
           #
           # Retrieves a user's current Do Not Disturb status.
           #
+          # @option options [Object] :team_id
+          #   Encoded team id where passed in user param belongs, required if org token is used. If no user param is passed, then a team which has access to the app should be passed.
           # @option options [user] :user
           #   User to fetch status for (defaults to current user).
           # @see https://api.slack.com/methods/dnd.info
@@ -53,6 +55,8 @@ module Slack
           #
           # @option options [Object] :users
           #   Comma-separated list of users to fetch Do Not Disturb status for.
+          # @option options [Object] :team_id
+          #   Encoded team id where passed in users belong, required if org token is used.
           # @see https://api.slack.com/methods/dnd.teamInfo
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/dnd/dnd.teamInfo.json
           def dnd_teamInfo(options = {})

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

@@ -36,7 +36,7 @@ module Slack
           end
 
           #
-          # Gets information about a team file.
+          # Gets information about a file.
           #
           # @option options [file] :file
           #   Specify a file by providing its ID.
@@ -58,10 +58,14 @@ module Slack
           end
 
           #
-          # Lists & filters team files.
+          # List for a team, in a channel, or from a user with applied filters.
           #
           # @option options [channel] :channel
           #   Filter files appearing in a specific channel, indicated by its ID.
+          # @option options [Object] :show_files_hidden_by_limit
+          #   Show truncated file info for files hidden due to being too old, and the team who owns the file being over the file limit.
+          # @option options [Object] :team_id
+          #   encoded team id to list files in, required if org token is used.
           # @option options [Object] :ts_from
           #   Filter files created after this timestamp (inclusive).
           # @option options [Object] :ts_to
@@ -73,7 +77,7 @@ module Slack
           # @see https://api.slack.com/methods/files.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.list.json
           def files_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]
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             post('files.list', options)
           end
@@ -101,7 +105,7 @@ module Slack
           def files_share(options = {})
             throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
             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 files.share method is undocumented.')
             post('files.share', options)
           end

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

@@ -18,7 +18,7 @@ module Slack
           # @option options [Object] :filetype
           #   type of file.
           # @option options [Object] :indexable_file_contents
-          #   File containing contents that can be used to improve searchability for the remote file.
+          #   A text file (txt, pdf, doc, etc.) containing textual search terms that are used to improve discovery of the remote file.
           # @option options [Object] :preview_image
           #   Preview of the document via multipart/form-data.
           # @see https://api.slack.com/methods/files.remote.add
@@ -59,7 +59,7 @@ module Slack
           # @see https://api.slack.com/methods/files.remote.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files.remote/files.remote.list.json
           def files_remote_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, :files_remote_list, options).each do |page|
                 yield page
@@ -88,9 +88,9 @@ module Slack
           # @option options [Object] :channels
           #   Comma-separated list of channel IDs where the file will be shared.
           # @option options [Object] :external_id
-          #   Creator defined GUID for the file.
+          #   The globally unique identifier (GUID) for the file, as set by the app registering the file with Slack.  Either this field or file or both are required.
           # @option options [file] :file
-          #   Specify a file by providing its ID.
+          #   Specify a file registered with Slack by providing its ID. Either this field or external_id or both are required.
           # @see https://api.slack.com/methods/files.remote.share
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files.remote/files.remote.share.json
           def files_remote_share(options = {})

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

@@ -6,259 +6,6 @@ module Slack
     module Api
       module Endpoints
         module Groups
-          #
-          # Archives a private channel.
-          #
-          # @option options [group] :channel
-          #   Private channel to archive.
-          # @see https://api.slack.com/methods/groups.archive
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.archive.json
-          def groups_archive(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
-            post('groups.archive', options)
-          end
-
-          #
-          # Creates a private channel.
-          #
-          # @option options [Object] :name
-          #   Name of private 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/groups.create
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.create.json
-          def groups_create(options = {})
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
-            post('groups.create', options)
-          end
-
-          #
-          # Clones and archives a private channel.
-          #
-          # @option options [group] :channel
-          #   Private channel to clone and archive.
-          # @see https://api.slack.com/methods/groups.createChild
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.createChild.json
-          def groups_createChild(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
-            post('groups.createChild', options)
-          end
-
-          #
-          # Fetches history of messages and events from a private channel.
-          #
-          # @option options [group] :channel
-          #   Private 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/groups.history
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.history.json
-          def groups_history(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
-            post('groups.history', options)
-          end
-
-          #
-          # Gets information about a private channel.
-          #
-          # @option options [group] :channel
-          #   Private channel to get info on.
-          # @option options [Object] :include_locale
-          #   Set this to true to receive the locale for this group. Defaults to false.
-          # @see https://api.slack.com/methods/groups.info
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.info.json
-          def groups_info(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
-            post('groups.info', options)
-          end
-
-          #
-          # Invites a user to a private channel.
-          #
-          # @option options [group] :channel
-          #   Private channel to invite user to.
-          # @option options [user] :user
-          #   User to invite.
-          # @see https://api.slack.com/methods/groups.invite
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.invite.json
-          def groups_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: groups_id(options)['group']['id']) if options[:channel]
-            options = options.merge(user: users_id(options)['user']['id']) if options[:user]
-            post('groups.invite', options)
-          end
-
-          #
-          # Removes a user from a private channel.
-          #
-          # @option options [group] :channel
-          #   Private channel to remove user from.
-          # @option options [user] :user
-          #   User to remove from private channel.
-          # @see https://api.slack.com/methods/groups.kick
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.kick.json
-          def groups_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: groups_id(options)['group']['id']) if options[:channel]
-            options = options.merge(user: users_id(options)['user']['id']) if options[:user]
-            post('groups.kick', options)
-          end
-
-          #
-          # Leaves a private channel.
-          #
-          # @option options [group] :channel
-          #   Private channel to leave.
-          # @see https://api.slack.com/methods/groups.leave
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.leave.json
-          def groups_leave(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
-            post('groups.leave', options)
-          end
-
-          #
-          # Lists private channels that the calling user has access to.
-          #
-          # @option options [Object] :cursor
-          #   Parameter for pagination. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first "page" of the collection. See pagination for more details.
-          # @option options [Object] :exclude_archived
-          #   Don't return archived private channels.
-          # @option options [Object] :exclude_members
-          #   Exclude the members from each group.
-          # @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 list hasn't been reached.
-          # @see https://api.slack.com/methods/groups.list
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.list.json
-          def groups_list(options = {})
-            if block_given?
-              Pagination::Cursor.new(self, :groups_list, options).each do |page|
-                yield page
-              end
-            else
-              post('groups.list', options)
-            end
-          end
-
-          #
-          # Sets the read cursor in a private channel.
-          #
-          # @option options [group] :channel
-          #   Private channel to set reading cursor in.
-          # @option options [timestamp] :ts
-          #   Timestamp of the most recently seen message.
-          # @see https://api.slack.com/methods/groups.mark
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.mark.json
-          def groups_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: groups_id(options)['group']['id']) if options[:channel]
-            post('groups.mark', options)
-          end
-
-          #
-          # Opens a private channel.
-          #
-          # @option options [group] :channel
-          #   Private channel to open.
-          # @see https://api.slack.com/methods/groups.open
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.open.json
-          def groups_open(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
-            post('groups.open', options)
-          end
-
-          #
-          # Renames a private channel.
-          #
-          # @option options [group] :channel
-          #   Private channel to rename.
-          # @option options [Object] :name
-          #   New name for private 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/groups.rename
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.rename.json
-          def groups_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: groups_id(options)['group']['id']) if options[:channel]
-            post('groups.rename', options)
-          end
-
-          #
-          # Retrieve a thread of messages posted to a private channel
-          #
-          # @option options [group] :channel
-          #   Private channel to fetch thread from.
-          # @option options [Object] :thread_ts
-          #   Unique identifier of a thread's parent message.
-          # @see https://api.slack.com/methods/groups.replies
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.replies.json
-          def groups_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: groups_id(options)['group']['id']) if options[:channel]
-            post('groups.replies', options)
-          end
-
-          #
-          # Sets the purpose for a private channel.
-          #
-          # @option options [group] :channel
-          #   Private channel to set the purpose of.
-          # @option options [Object] :purpose
-          #   The new purpose.
-          # @see https://api.slack.com/methods/groups.setPurpose
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.setPurpose.json
-          def groups_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: groups_id(options)['group']['id']) if options[:channel]
-            post('groups.setPurpose', options)
-          end
-
-          #
-          # Sets the topic for a private channel.
-          #
-          # @option options [group] :channel
-          #   Private channel to set the topic of.
-          # @option options [Object] :topic
-          #   The new topic.
-          # @see https://api.slack.com/methods/groups.setTopic
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.setTopic.json
-          def groups_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: groups_id(options)['group']['id']) if options[:channel]
-            post('groups.setTopic', options)
-          end
-
-          #
-          # Unarchives a private channel.
-          #
-          # @option options [group] :channel
-          #   Private channel to unarchive.
-          # @see https://api.slack.com/methods/groups.unarchive
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.unarchive.json
-          def groups_unarchive(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
-            post('groups.unarchive', options)
-          end
         end
       end
     end