slack-ruby-client 1.0.0 → 2.1.0

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

@@ -16,8 +16,8 @@ module Slack
           # @see https://api.slack.com/methods/calls.participants.add
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls.participants/calls.participants.add.json
           def calls_participants_add(options = {})
-            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
-            throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?
+            raise ArgumentError, 'Required arguments :id missing' if options[:id].nil?
+            raise ArgumentError, 'Required arguments :users missing' if options[:users].nil?
             post('calls.participants.add', options)
           end
 
@@ -31,8 +31,8 @@ module Slack
           # @see https://api.slack.com/methods/calls.participants.remove
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls.participants/calls.participants.remove.json
           def calls_participants_remove(options = {})
-            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
-            throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?
+            raise ArgumentError, 'Required arguments :id missing' if options[:id].nil?
+            raise ArgumentError, 'Required arguments :users missing' if options[:users].nil?
             post('calls.participants.remove', options)
           end
         end

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

@@ -17,8 +17,8 @@ module Slack
           #   Additional parameters provided to the slash command.
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/undocumented/chat/chat.command.json
           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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :command missing' if options[:command].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             logger.warn('The chat.command method is undocumented.')
             post('chat.command', options)
@@ -36,8 +36,8 @@ module Slack
           # @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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :ts missing' if options[:ts].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('chat.delete', options)
           end
@@ -54,8 +54,8 @@ module Slack
           # @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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :scheduled_message_id missing' if options[:scheduled_message_id].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('chat.deleteScheduledMessage', options)
           end
@@ -70,8 +70,8 @@ module Slack
           # @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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :message_ts missing' if options[:message_ts].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('chat.getPermalink', options)
           end
@@ -86,8 +86,8 @@ module Slack
           # @see https://api.slack.com/methods/chat.meMessage
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.meMessage.json
           def chat_meMessage(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :text missing') if options[:text].nil?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :text missing' if options[:text].nil?
             post('chat.meMessage', options)
           end
 
@@ -101,7 +101,7 @@ module Slack
           # @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 [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.
+          #   (Legacy) 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 [string] :attachments
           #   A JSON-based array of structured attachments, presented as a URL-encoded string.
           # @option options [blocks[] as string] :blocks
@@ -121,9 +121,9 @@ module Slack
           # @see https://api.slack.com/methods/chat.postEphemeral
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postEphemeral.json
           def chat_postEphemeral(options = {})
-            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 :user missing') if options[:user].nil?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :text, :attachments or :blocks missing' if options[:text].nil? && options[:attachments].nil? && options[:blocks].nil?
+            raise ArgumentError, 'Required arguments :user missing' if options[:user].nil?
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             # attachments must be passed as an encoded JSON string
             if options.key?(:attachments)
@@ -152,17 +152,19 @@ module Slack
           # @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.
+          #   (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.
           # @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.
+          #   Find and link user groups. No longer supports linking individual users; use syntax shown in Mentioning Users instead.
+          # @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
           #   Disable Slack markup parsing by setting to false. Enabled by default.
           # @option options [string] :parse
-          #   Change how messages are treated. Defaults to none. See below.
+          #   Change how messages are treated. See below.
           # @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 [string] :thread_ts
@@ -176,8 +178,8 @@ module Slack
           # @see https://api.slack.com/methods/chat.postMessage
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postMessage.json
           def chat_postMessage(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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :text, :attachments or :blocks missing' if options[:text].nil? && options[:attachments].nil? && options[:blocks].nil?
             # attachments must be passed as an encoded JSON string
             if options.key?(:attachments)
               attachments = options[:attachments]
@@ -203,15 +205,17 @@ 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
-          #   Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See chat.postMessage.
+          #   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 [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 [boolean] :link_names
-          #   Find and link channel names and usernames.
+          #   Find and link user groups. No longer supports linking individual users; use syntax shown in Mentioning Users instead.
+          # @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 [string] :parse
-          #   Change how messages are treated. Defaults to none. See chat.postMessage.
+          #   Change how messages are treated. See chat.postMessage.
           # @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 [string] :thread_ts
@@ -223,9 +227,9 @@ module Slack
           # @see https://api.slack.com/methods/chat.scheduleMessage
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.scheduleMessage.json
           def chat_scheduleMessage(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :post_at missing') if options[:post_at].nil?
-            throw ArgumentError.new('Required arguments :text missing') if options[:text].nil?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :post_at missing' if options[:post_at].nil?
+            raise ArgumentError, 'Required arguments :text missing' if options[:text].nil?
             post('chat.scheduleMessage', options)
           end
 
@@ -253,9 +257,9 @@ module Slack
           # @see https://api.slack.com/methods/chat.unfurl
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.unfurl.json
           def chat_unfurl(options = {})
-            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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :ts missing' if options[:ts].nil?
+            raise ArgumentError, 'Required arguments :unfurls missing' if options[:unfurls].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('chat.unfurl', options)
           end
@@ -277,6 +281,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] :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
           #   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
@@ -286,9 +292,9 @@ module Slack
           # @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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :text, :attachments, :blocks or :reply_broadcast missing' if options[:text].nil? && options[:attachments].nil? && options[:blocks].nil? && options[:reply_broadcast].nil?
+            raise ArgumentError, 'Required arguments :ts missing' if options[:ts].nil?
             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)

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

@@ -19,12 +19,12 @@ module Slack
           #   See the shared_channel_invite_received event payload for more details on how to retrieve the ID of the invitation.
           # @option options [boolean] :is_private
           #   Whether the channel should be private.
-          # @option options [string] :team_id
+          # @option options [Object] :team_id
           #   The ID of the workspace to accept the channel in. If an org-level token is used to call this method, the team_id argument is required.
           # @see https://api.slack.com/methods/conversations.acceptSharedInvite
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.acceptSharedInvite.json
           def conversations_acceptSharedInvite(options = {})
-            throw ArgumentError.new('Required arguments :channel_name missing') if options[:channel_name].nil?
+            raise ArgumentError, 'Required arguments :channel_name missing' if options[:channel_name].nil?
             post('conversations.acceptSharedInvite', options)
           end
 
@@ -38,7 +38,7 @@ module Slack
           # @see https://api.slack.com/methods/conversations.approveSharedInvite
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.approveSharedInvite.json
           def conversations_approveSharedInvite(options = {})
-            throw ArgumentError.new('Required arguments :invite_id missing') if options[:invite_id].nil?
+            raise ArgumentError, 'Required arguments :invite_id missing' if options[:invite_id].nil?
             post('conversations.approveSharedInvite', options)
           end
 
@@ -50,7 +50,7 @@ module Slack
           # @see https://api.slack.com/methods/conversations.archive
           # @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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.archive', options)
           end
@@ -63,7 +63,7 @@ module Slack
           # @see https://api.slack.com/methods/conversations.close
           # @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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.close', options)
           end
@@ -80,7 +80,7 @@ module Slack
           # @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 = {})
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
+            raise ArgumentError, 'Required arguments :name missing' if options[:name].nil?
             post('conversations.create', options)
           end
 
@@ -94,7 +94,7 @@ module Slack
           # @see https://api.slack.com/methods/conversations.declineSharedInvite
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.declineSharedInvite.json
           def conversations_declineSharedInvite(options = {})
-            throw ArgumentError.new('Required arguments :invite_id missing') if options[:invite_id].nil?
+            raise ArgumentError, 'Required arguments :invite_id missing' if options[:invite_id].nil?
             post('conversations.declineSharedInvite', options)
           end
 
@@ -105,18 +105,20 @@ module Slack
           #   Conversation ID to fetch history for.
           # @option options [string] :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 [boolean] :include_all_metadata
+          #   Return all metadata associated with this message.
           # @option options [boolean] :inclusive
-          #   Include messages with latest or oldest timestamp in results only when either timestamp is specified.
+          #   Include messages with oldest or latest timestamps in results. Ignored unless either timestamp is specified.
           # @option options [timestamp] :latest
-          #   End of time range of messages to include in results. Default is the current time.
+          #   Only messages before this Unix timestamp will be included in results. Default is the current time.
           # @option options [number] :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.
           # @option options [timestamp] :oldest
-          #   Start of time range of messages to include in results.
+          #   Only messages after this Unix timestamp will be included in results.
           # @see https://api.slack.com/methods/conversations.history
           # @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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             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|
@@ -139,7 +141,7 @@ module Slack
           # @see https://api.slack.com/methods/conversations.info
           # @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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.info', options)
           end
@@ -154,8 +156,8 @@ module Slack
           # @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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :users missing' if options[:users].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.invite', options)
           end
@@ -174,7 +176,7 @@ module Slack
           # @see https://api.slack.com/methods/conversations.inviteShared
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.inviteShared.json
           def conversations_inviteShared(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.inviteShared', options)
           end
@@ -187,7 +189,7 @@ module Slack
           # @see https://api.slack.com/methods/conversations.join
           # @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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.join', options)
           end
@@ -202,8 +204,8 @@ module Slack
           # @see https://api.slack.com/methods/conversations.kick
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.kick.json
           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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :user missing' if options[:user].nil?
             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)
@@ -217,7 +219,7 @@ module Slack
           # @see https://api.slack.com/methods/conversations.leave
           # @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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.leave', options)
           end
@@ -276,8 +278,8 @@ module Slack
           # @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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, '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
@@ -294,7 +296,7 @@ module Slack
           # @see https://api.slack.com/methods/conversations.members
           # @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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             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|
@@ -333,8 +335,8 @@ module Slack
           # @see https://api.slack.com/methods/conversations.rename
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.rename.json
           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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :name missing' if options[:name].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.rename', options)
           end
@@ -348,19 +350,21 @@ module Slack
           #   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 [string] :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 [boolean] :include_all_metadata
+          #   Return all metadata associated with this message.
           # @option options [boolean] :inclusive
-          #   Include messages with latest or oldest timestamp in results only when either timestamp is specified.
+          #   Include messages with oldest or latest timestamps in results. Ignored unless either timestamp is specified.
           # @option options [timestamp] :latest
-          #   End of time range of messages to include in results.
+          #   Only messages before this Unix timestamp will be included in results.
           # @option options [number] :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.
           # @option options [timestamp] :oldest
-          #   Start of time range of messages to include in results.
+          #   Only messages after this Unix timestamp will be included in results.
           # @see https://api.slack.com/methods/conversations.replies
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.replies.json
           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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :ts missing' if options[:ts].nil?
             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|
@@ -381,8 +385,8 @@ module Slack
           # @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 = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :purpose missing') if options[:purpose].nil?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :purpose missing' if options[:purpose].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.setPurpose', options)
           end
@@ -397,8 +401,8 @@ module Slack
           # @see https://api.slack.com/methods/conversations.setTopic
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.setTopic.json
           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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :topic missing' if options[:topic].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.setTopic', options)
           end
@@ -411,7 +415,7 @@ module Slack
           # @see https://api.slack.com/methods/conversations.unarchive
           # @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?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('conversations.unarchive', options)
           end

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

@@ -16,8 +16,8 @@ module Slack
           # @see https://api.slack.com/methods/dialog.open
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/dialog/dialog.open.json
           def dialog_open(options = {})
-            throw ArgumentError.new('Required arguments :dialog missing') if options[:dialog].nil?
-            throw ArgumentError.new('Required arguments :trigger_id missing') if options[:trigger_id].nil?
+            raise ArgumentError, 'Required arguments :dialog missing' if options[:dialog].nil?
+            raise ArgumentError, 'Required arguments :trigger_id missing' if options[:trigger_id].nil?
             # dialog must be passed as an encoded JSON string
             if options.key?(:dialog)
               dialog = options[:dialog]

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

@@ -59,7 +59,7 @@ module Slack
           # @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 = {})
-            throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?
+            raise ArgumentError, 'Required arguments :users missing' if options[:users].nil?
             post('dnd.teamInfo', options)
           end
         end

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

@@ -9,6 +9,8 @@ module Slack
           #
           # Lists custom emoji for a team.
           #
+          # @option options [boolean] :include_categories
+          #   Include a list of categories for Unicode emoji and the emoji in each category.
           # @see https://api.slack.com/methods/emoji.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/emoji/emoji.list.json
           def emoji_list(options = {})

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

@@ -6,6 +6,24 @@ module Slack
     module Api
       module Endpoints
         module Files
+          #
+          # Finishes an upload started with files.getUploadURLExternal
+          #
+          # @option options [array] :files
+          #   Array of file ids and their corresponding (optional) titles.
+          # @option options [Object] :channel_id
+          #   Channel ID where the file will be shared. If not specified the file will be private.
+          # @option options [string] :initial_comment
+          #   The message text introducing the file in specified channels.
+          # @option options [string] :thread_ts
+          #   Provide another message's ts value to upload this file as a reply. Never use a reply's ts value; use its parent instead.
+          # @see https://api.slack.com/methods/files.completeUploadExternal
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.completeUploadExternal.json
+          def files_completeUploadExternal(options = {})
+            raise ArgumentError, 'Required arguments :files missing' if options[:files].nil?
+            post('files.completeUploadExternal', options)
+          end
+
           #
           # Deletes a file.
           #
@@ -14,7 +32,7 @@ module Slack
           # @see https://api.slack.com/methods/files.delete
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.delete.json
           def files_delete(options = {})
-            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
+            raise ArgumentError, 'Required arguments :file missing' if options[:file].nil?
             post('files.delete', options)
           end
 
@@ -29,12 +47,31 @@ module Slack
           #   New filetype of the file. See https://api.slack.com/types/file#file_types for a list of all supported types.
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/undocumented/files/files.edit.json
           def files_edit(options = {})
-            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
-            throw ArgumentError.new('Required arguments :title missing') if options[:title].nil?
+            raise ArgumentError, 'Required arguments :file missing' if options[:file].nil?
+            raise ArgumentError, 'Required arguments :title missing' if options[:title].nil?
             logger.warn('The files.edit method is undocumented.')
             post('files.edit', options)
           end
 
+          #
+          # Gets a URL for an edge external file upload
+          #
+          # @option options [string] :filename
+          #   Name of the file being uploaded.
+          # @option options [integer] :length
+          #   Size in bytes of the file being uploaded.
+          # @option options [string] :alt_txt
+          #   Description of image for screen-reader.
+          # @option options [string] :snippet_type
+          #   Syntax type of the snippet being uploaded.
+          # @see https://api.slack.com/methods/files.getUploadURLExternal
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.getUploadURLExternal.json
+          def files_getUploadURLExternal(options = {})
+            raise ArgumentError, 'Required arguments :filename missing' if options[:filename].nil?
+            raise ArgumentError, 'Required arguments :length missing' if options[:length].nil?
+            post('files.getUploadURLExternal', options)
+          end
+
           #
           # Gets information about a file.
           #
@@ -47,7 +84,7 @@ module Slack
           # @see https://api.slack.com/methods/files.info
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.info.json
           def files_info(options = {})
-            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
+            raise ArgumentError, 'Required arguments :file missing' if options[:file].nil?
             if block_given?
               Pagination::Cursor.new(self, :files_info, options).each do |page|
                 yield page
@@ -62,8 +99,6 @@ module Slack
           #
           # @option options [channel] :channel
           #   Filter files appearing in a specific channel, indicated by its ID.
-          # @option options [string] :files
-          #   .
           # @option options [boolean] :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 [string] :team_id
@@ -92,7 +127,7 @@ module Slack
           # @see https://api.slack.com/methods/files.revokePublicURL
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.revokePublicURL.json
           def files_revokePublicURL(options = {})
-            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
+            raise ArgumentError, 'Required arguments :file missing' if options[:file].nil?
             post('files.revokePublicURL', options)
           end
 
@@ -105,8 +140,8 @@ module Slack
           #   Channel to share the file in. Works with both public (channel ID) and private channels (group ID).
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/undocumented/files/files.share.json
           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?
+            raise ArgumentError, 'Required arguments :file missing' if options[:file].nil?
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             logger.warn('The files.share method is undocumented.')
             post('files.share', options)
@@ -120,7 +155,7 @@ module Slack
           # @see https://api.slack.com/methods/files.sharedPublicURL
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.sharedPublicURL.json
           def files_sharedPublicURL(options = {})
-            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
+            raise ArgumentError, 'Required arguments :file missing' if options[:file].nil?
             post('files.sharedPublicURL', options)
           end
 

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

@@ -16,8 +16,8 @@ module Slack
           # @see https://api.slack.com/methods/files.comments.delete
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files.comments/files.comments.delete.json
           def files_comments_delete(options = {})
-            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
-            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
+            raise ArgumentError, 'Required arguments :file missing' if options[:file].nil?
+            raise ArgumentError, 'Required arguments :id missing' if options[:id].nil?
             post('files.comments.delete', options)
           end
         end