slack-ruby-client 1.1.0 → 2.0.0

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

@@ -22,8 +22,8 @@ module Slack
           # @see https://api.slack.com/methods/admin.users.assign
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users/admin.users.assign.json
           def admin_users_assign(options = {})
-            throw ArgumentError.new('Required arguments :team_id missing') if options[:team_id].nil?
-            throw ArgumentError.new('Required arguments :user_id missing') if options[:user_id].nil?
+            raise ArgumentError, 'Required arguments :team_id missing' if options[:team_id].nil?
+            raise ArgumentError, 'Required arguments :user_id missing' if options[:user_id].nil?
             post('admin.users.assign', options)
           end
 
@@ -53,9 +53,9 @@ module Slack
           # @see https://api.slack.com/methods/admin.users.invite
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users/admin.users.invite.json
           def admin_users_invite(options = {})
-            throw ArgumentError.new('Required arguments :channel_ids missing') if options[:channel_ids].nil?
-            throw ArgumentError.new('Required arguments :email missing') if options[:email].nil?
-            throw ArgumentError.new('Required arguments :team_id missing') if options[:team_id].nil?
+            raise ArgumentError, 'Required arguments :channel_ids missing' if options[:channel_ids].nil?
+            raise ArgumentError, 'Required arguments :email missing' if options[:email].nil?
+            raise ArgumentError, 'Required arguments :team_id missing' if options[:team_id].nil?
             post('admin.users.invite', options)
           end
 
@@ -67,7 +67,7 @@ module Slack
           # @option options [integer] :limit
           #   Limit for how many users to be retrieved per page.
           # @option options [Object] :team_id
-          #   The ID (T1234) of the workspace.
+          #   The ID (T1234) of the workspace. The team_id is required if you use an org-level token.
           # @see https://api.slack.com/methods/admin.users.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users/admin.users.list.json
           def admin_users_list(options = {})
@@ -90,8 +90,8 @@ module Slack
           # @see https://api.slack.com/methods/admin.users.remove
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users/admin.users.remove.json
           def admin_users_remove(options = {})
-            throw ArgumentError.new('Required arguments :team_id missing') if options[:team_id].nil?
-            throw ArgumentError.new('Required arguments :user_id missing') if options[:user_id].nil?
+            raise ArgumentError, 'Required arguments :team_id missing' if options[:team_id].nil?
+            raise ArgumentError, 'Required arguments :user_id missing' if options[:user_id].nil?
             post('admin.users.remove', options)
           end
 
@@ -105,8 +105,8 @@ module Slack
           # @see https://api.slack.com/methods/admin.users.setAdmin
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users/admin.users.setAdmin.json
           def admin_users_setAdmin(options = {})
-            throw ArgumentError.new('Required arguments :team_id missing') if options[:team_id].nil?
-            throw ArgumentError.new('Required arguments :user_id missing') if options[:user_id].nil?
+            raise ArgumentError, 'Required arguments :team_id missing' if options[:team_id].nil?
+            raise ArgumentError, 'Required arguments :user_id missing' if options[:user_id].nil?
             post('admin.users.setAdmin', options)
           end
 
@@ -122,8 +122,8 @@ module Slack
           # @see https://api.slack.com/methods/admin.users.setExpiration
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users/admin.users.setExpiration.json
           def admin_users_setExpiration(options = {})
-            throw ArgumentError.new('Required arguments :expiration_ts missing') if options[:expiration_ts].nil?
-            throw ArgumentError.new('Required arguments :user_id missing') if options[:user_id].nil?
+            raise ArgumentError, 'Required arguments :expiration_ts missing' if options[:expiration_ts].nil?
+            raise ArgumentError, 'Required arguments :user_id missing' if options[:user_id].nil?
             post('admin.users.setExpiration', options)
           end
 
@@ -137,8 +137,8 @@ module Slack
           # @see https://api.slack.com/methods/admin.users.setOwner
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users/admin.users.setOwner.json
           def admin_users_setOwner(options = {})
-            throw ArgumentError.new('Required arguments :team_id missing') if options[:team_id].nil?
-            throw ArgumentError.new('Required arguments :user_id missing') if options[:user_id].nil?
+            raise ArgumentError, 'Required arguments :team_id missing' if options[:team_id].nil?
+            raise ArgumentError, 'Required arguments :user_id missing' if options[:user_id].nil?
             post('admin.users.setOwner', options)
           end
 
@@ -152,8 +152,8 @@ module Slack
           # @see https://api.slack.com/methods/admin.users.setRegular
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users/admin.users.setRegular.json
           def admin_users_setRegular(options = {})
-            throw ArgumentError.new('Required arguments :team_id missing') if options[:team_id].nil?
-            throw ArgumentError.new('Required arguments :user_id missing') if options[:user_id].nil?
+            raise ArgumentError, 'Required arguments :team_id missing' if options[:team_id].nil?
+            raise ArgumentError, 'Required arguments :user_id missing' if options[:user_id].nil?
             post('admin.users.setRegular', options)
           end
         end

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

@@ -14,7 +14,7 @@ module Slack
           # @see https://api.slack.com/methods/admin.users.session.clearSettings
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users.session/admin.users.session.clearSettings.json
           def admin_users_session_clearSettings(options = {})
-            throw ArgumentError.new('Required arguments :user_ids missing') if options[:user_ids].nil?
+            raise ArgumentError, 'Required arguments :user_ids missing' if options[:user_ids].nil?
             post('admin.users.session.clearSettings', options)
           end
 
@@ -26,7 +26,7 @@ module Slack
           # @see https://api.slack.com/methods/admin.users.session.getSettings
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users.session/admin.users.session.getSettings.json
           def admin_users_session_getSettings(options = {})
-            throw ArgumentError.new('Required arguments :user_ids missing') if options[:user_ids].nil?
+            raise ArgumentError, 'Required arguments :user_ids missing' if options[:user_ids].nil?
             post('admin.users.session.getSettings', options)
           end
 
@@ -40,8 +40,8 @@ module Slack
           # @see https://api.slack.com/methods/admin.users.session.invalidate
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users.session/admin.users.session.invalidate.json
           def admin_users_session_invalidate(options = {})
-            throw ArgumentError.new('Required arguments :session_id missing') if options[:session_id].nil?
-            throw ArgumentError.new('Required arguments :team_id missing') if options[:team_id].nil?
+            raise ArgumentError, 'Required arguments :session_id missing' if options[:session_id].nil?
+            raise ArgumentError, 'Required arguments :team_id missing' if options[:team_id].nil?
             post('admin.users.session.invalidate', options)
           end
 
@@ -80,7 +80,7 @@ module Slack
           # @see https://api.slack.com/methods/admin.users.session.reset
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users.session/admin.users.session.reset.json
           def admin_users_session_reset(options = {})
-            throw ArgumentError.new('Required arguments :user_id missing') if options[:user_id].nil?
+            raise ArgumentError, 'Required arguments :user_id missing' if options[:user_id].nil?
             post('admin.users.session.reset', options)
           end
 
@@ -96,7 +96,7 @@ module Slack
           # @see https://api.slack.com/methods/admin.users.session.resetBulk
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users.session/admin.users.session.resetBulk.json
           def admin_users_session_resetBulk(options = {})
-            throw ArgumentError.new('Required arguments :user_ids missing') if options[:user_ids].nil?
+            raise ArgumentError, 'Required arguments :user_ids missing' if options[:user_ids].nil?
             post('admin.users.session.resetBulk', options)
           end
 
@@ -104,7 +104,7 @@ module Slack
           # Configure the user-level session settings—the session duration and what happens when the client closes—for one or more users.
           #
           # @option options [array] :user_ids
-          #   The list of user IDs to apply the session settings for.
+          #   The list of up to 1,000 user IDs to apply the session settings for.
           # @option options [boolean] :desktop_app_browser_quit
           #   Terminate the session when the client—either the desktop app or a browser window—is closed.
           # @option options [integer] :duration
@@ -112,7 +112,7 @@ module Slack
           # @see https://api.slack.com/methods/admin.users.session.setSettings
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users.session/admin.users.session.setSettings.json
           def admin_users_session_setSettings(options = {})
-            throw ArgumentError.new('Required arguments :user_ids missing') if options[:user_ids].nil?
+            raise ArgumentError, 'Required arguments :user_ids missing' if options[:user_ids].nil?
             post('admin.users.session.setSettings', options)
           end
         end

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

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

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

@@ -7,7 +7,7 @@ module Slack
       module Endpoints
         module AppsConnections
           #
-          # Generate a temporary Socket Mode WebSocket URL that your app can connect to in order to receive events and interactive payloads over,
+          # Generate a temporary Socket Mode WebSocket URL that your app can connect to in order to receive events and interactive payloads over.
           #
           # @see https://api.slack.com/methods/apps.connections.open
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.connections/apps.connections.open.json

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

@@ -18,7 +18,7 @@ module Slack
           # @see https://api.slack.com/methods/apps.event.authorizations.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.event.authorizations/apps.event.authorizations.list.json
           def apps_event_authorizations_list(options = {})
-            throw ArgumentError.new('Required arguments :event_context missing') if options[:event_context].nil?
+            raise ArgumentError, 'Required arguments :event_context missing' if options[:event_context].nil?
             if block_given?
               Pagination::Cursor.new(self, :apps_event_authorizations_list, options).each do |page|
                 yield page

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

@@ -14,7 +14,7 @@ module Slack
           # @see https://api.slack.com/methods/apps.manifest.create
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.manifest/apps.manifest.create.json
           def apps_manifest_create(options = {})
-            throw ArgumentError.new('Required arguments :manifest missing') if options[:manifest].nil?
+            raise ArgumentError, 'Required arguments :manifest missing' if options[:manifest].nil?
             post('apps.manifest.create', options)
           end
 
@@ -26,7 +26,7 @@ module Slack
           # @see https://api.slack.com/methods/apps.manifest.delete
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.manifest/apps.manifest.delete.json
           def apps_manifest_delete(options = {})
-            throw ArgumentError.new('Required arguments :app_id missing') if options[:app_id].nil?
+            raise ArgumentError, 'Required arguments :app_id missing' if options[:app_id].nil?
             post('apps.manifest.delete', options)
           end
 
@@ -38,7 +38,7 @@ module Slack
           # @see https://api.slack.com/methods/apps.manifest.export
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.manifest/apps.manifest.export.json
           def apps_manifest_export(options = {})
-            throw ArgumentError.new('Required arguments :app_id missing') if options[:app_id].nil?
+            raise ArgumentError, 'Required arguments :app_id missing' if options[:app_id].nil?
             post('apps.manifest.export', options)
           end
 
@@ -52,8 +52,8 @@ module Slack
           # @see https://api.slack.com/methods/apps.manifest.update
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.manifest/apps.manifest.update.json
           def apps_manifest_update(options = {})
-            throw ArgumentError.new('Required arguments :app_id missing') if options[:app_id].nil?
-            throw ArgumentError.new('Required arguments :manifest missing') if options[:manifest].nil?
+            raise ArgumentError, 'Required arguments :app_id missing' if options[:app_id].nil?
+            raise ArgumentError, 'Required arguments :manifest missing' if options[:manifest].nil?
             post('apps.manifest.update', options)
           end
 
@@ -67,7 +67,7 @@ module Slack
           # @see https://api.slack.com/methods/apps.manifest.validate
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.manifest/apps.manifest.validate.json
           def apps_manifest_validate(options = {})
-            throw ArgumentError.new('Required arguments :manifest missing') if options[:manifest].nil?
+            raise ArgumentError, 'Required arguments :manifest missing' if options[:manifest].nil?
             post('apps.manifest.validate', options)
           end
         end

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

@@ -26,9 +26,9 @@ module Slack
           # @see https://api.slack.com/methods/bookmarks.add
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/bookmarks/bookmarks.add.json
           def bookmarks_add(options = {})
-            throw ArgumentError.new('Required arguments :channel_id missing') if options[:channel_id].nil?
-            throw ArgumentError.new('Required arguments :title missing') if options[:title].nil?
-            throw ArgumentError.new('Required arguments :type missing') if options[:type].nil?
+            raise ArgumentError, 'Required arguments :channel_id missing' if options[:channel_id].nil?
+            raise ArgumentError, 'Required arguments :title missing' if options[:title].nil?
+            raise ArgumentError, 'Required arguments :type missing' if options[:type].nil?
             post('bookmarks.add', options)
           end
 
@@ -48,8 +48,8 @@ module Slack
           # @see https://api.slack.com/methods/bookmarks.edit
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/bookmarks/bookmarks.edit.json
           def bookmarks_edit(options = {})
-            throw ArgumentError.new('Required arguments :bookmark_id missing') if options[:bookmark_id].nil?
-            throw ArgumentError.new('Required arguments :channel_id missing') if options[:channel_id].nil?
+            raise ArgumentError, 'Required arguments :bookmark_id missing' if options[:bookmark_id].nil?
+            raise ArgumentError, 'Required arguments :channel_id missing' if options[:channel_id].nil?
             post('bookmarks.edit', options)
           end
 
@@ -61,7 +61,7 @@ module Slack
           # @see https://api.slack.com/methods/bookmarks.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/bookmarks/bookmarks.list.json
           def bookmarks_list(options = {})
-            throw ArgumentError.new('Required arguments :channel_id missing') if options[:channel_id].nil?
+            raise ArgumentError, 'Required arguments :channel_id missing' if options[:channel_id].nil?
             post('bookmarks.list', options)
           end
 
@@ -72,11 +72,13 @@ module Slack
           #   Bookmark to remove.
           # @option options [string] :channel_id
           #   Channel to remove bookmark.
+          # @option options [string] :quip_section_id
+          #   Quip section ID to unbookmark.
           # @see https://api.slack.com/methods/bookmarks.remove
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/bookmarks/bookmarks.remove.json
           def bookmarks_remove(options = {})
-            throw ArgumentError.new('Required arguments :bookmark_id missing') if options[:bookmark_id].nil?
-            throw ArgumentError.new('Required arguments :channel_id missing') if options[:channel_id].nil?
+            raise ArgumentError, 'Required arguments :bookmark_id missing' if options[:bookmark_id].nil?
+            raise ArgumentError, 'Required arguments :channel_id missing' if options[:channel_id].nil?
             post('bookmarks.remove', options)
           end
         end

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

@@ -11,7 +11,7 @@ module Slack
           #
           # @option options [user] :bot
           #   Bot user to get info on.
-          # @option options [team] :team_id
+          # @option options [string] :team_id
           #   encoded team id or enterprise id where the bot exists, required if org token is used.
           # @see https://api.slack.com/methods/bots.info
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/bots/bots.info.json

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

@@ -28,8 +28,8 @@ module Slack
           # @see https://api.slack.com/methods/calls.add
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls/calls.add.json
           def calls_add(options = {})
-            throw ArgumentError.new('Required arguments :external_unique_id missing') if options[:external_unique_id].nil?
-            throw ArgumentError.new('Required arguments :join_url missing') if options[:join_url].nil?
+            raise ArgumentError, 'Required arguments :external_unique_id missing' if options[:external_unique_id].nil?
+            raise ArgumentError, 'Required arguments :join_url missing' if options[:join_url].nil?
             post('calls.add', options)
           end
 
@@ -43,7 +43,7 @@ module Slack
           # @see https://api.slack.com/methods/calls.end
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls/calls.end.json
           def calls_end(options = {})
-            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
+            raise ArgumentError, 'Required arguments :id missing' if options[:id].nil?
             post('calls.end', options)
           end
 
@@ -55,7 +55,7 @@ module Slack
           # @see https://api.slack.com/methods/calls.info
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls/calls.info.json
           def calls_info(options = {})
-            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
+            raise ArgumentError, 'Required arguments :id missing' if options[:id].nil?
             post('calls.info', options)
           end
 
@@ -73,7 +73,7 @@ module Slack
           # @see https://api.slack.com/methods/calls.update
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls/calls.update.json
           def calls_update(options = {})
-            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
+            raise ArgumentError, 'Required arguments :id missing' if options[:id].nil?
             post('calls.update', options)
           end
         end

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
 
@@ -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.
+          #   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 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, :blocks or :reply_broadcast missing') if options[:text].nil? && options[:attachments].nil? && options[:blocks].nil? && options[:reply_broadcast].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)