slack-ruby-client 0.13.1 → 2.0.0

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -8,21 +9,19 @@ module Slack
           #
           # Adds a reaction to an item.
           #
-          # @option options [Object] :name
-          #   Reaction (emoji) name.
           # @option options [channel] :channel
           #   Channel where the message to add reaction to was posted.
-          # @option options [file] :file
-          #   File to add reaction to.
-          # @option options [Object] :file_comment
-          #   File comment to add reaction to.
-          # @option options [Object] :timestamp
+          # @option options [string] :name
+          #   Reaction (emoji) name.
+          # @option options [string] :timestamp
           #   Timestamp of the message to add reaction to.
           # @see https://api.slack.com/methods/reactions.add
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reactions/reactions.add.json
           def reactions_add(options = {})
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :name missing' if options[:name].nil?
+            raise ArgumentError, 'Required arguments :timestamp missing' if options[:timestamp].nil?
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('reactions.add', options)
           end
 
@@ -33,28 +32,30 @@ module Slack
           #   Channel where the message to get reactions for was posted.
           # @option options [file] :file
           #   File to get reactions for.
-          # @option options [Object] :file_comment
+          # @option options [string] :file_comment
           #   File comment to get reactions for.
-          # @option options [Object] :full
+          # @option options [boolean] :full
           #   If true always return the complete reaction list.
-          # @option options [Object] :timestamp
+          # @option options [string] :timestamp
           #   Timestamp of the message to get reactions for.
           # @see https://api.slack.com/methods/reactions.get
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reactions/reactions.get.json
           def reactions_get(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('reactions.get', options)
           end
 
           #
           # Lists reactions made by a user.
           #
-          # @option options [Object] :cursor
+          # @option options [string] :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] :full
+          # @option options [boolean] :full
           #   If true always return the complete reaction list.
-          # @option options [Object] :limit
+          # @option options [integer] :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.
+          # @option options [string] :team_id
+          #   encoded team id to list reactions in, required if org token is used.
           # @option options [user] :user
           #   Show reactions made by this user. Defaults to the authed user.
           # @see https://api.slack.com/methods/reactions.list
@@ -73,21 +74,21 @@ module Slack
           #
           # Removes a reaction from an item.
           #
-          # @option options [Object] :name
+          # @option options [string] :name
           #   Reaction (emoji) name.
           # @option options [channel] :channel
           #   Channel where the message to remove reaction from was posted.
           # @option options [file] :file
           #   File to remove reaction from.
-          # @option options [Object] :file_comment
+          # @option options [string] :file_comment
           #   File comment to remove reaction from.
-          # @option options [Object] :timestamp
+          # @option options [string] :timestamp
           #   Timestamp of the message to remove reaction from.
           # @see https://api.slack.com/methods/reactions.remove
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reactions/reactions.remove.json
           def reactions_remove(options = {})
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            raise ArgumentError, 'Required arguments :name missing' if options[:name].nil?
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('reactions.remove', options)
           end
         end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -8,17 +9,21 @@ module Slack
           #
           # Creates a reminder.
           #
-          # @option options [Object] :text
+          # @option options [string] :text
           #   The content of the reminder.
-          # @option options [Object] :time
+          # @option options [string] :time
           #   When this reminder should happen: the Unix timestamp (up to five years from now), the number of seconds until the reminder (if within 24 hours), or a natural language description (Ex. "in 15 minutes," or "every Thursday").
+          # @option options [object] :recurrence
+          #   Specify the repeating behavior of a reminder. Available options: daily, weekly, monthly, or yearly. If weekly, may further specify the days of the week.
+          # @option options [string] :team_id
+          #   Encoded team id, required if org token is used.
           # @option options [user] :user
           #   The user who will receive the reminder. If no user is specified, the reminder will go to user who created it.
           # @see https://api.slack.com/methods/reminders.add
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reminders/reminders.add.json
           def reminders_add(options = {})
-            throw ArgumentError.new('Required arguments :text missing') if options[:text].nil?
-            throw ArgumentError.new('Required arguments :time missing') if options[:time].nil?
+            raise ArgumentError, 'Required arguments :text missing' if options[:text].nil?
+            raise ArgumentError, 'Required arguments :time missing' if options[:time].nil?
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             post('reminders.add', options)
           end
@@ -26,42 +31,50 @@ module Slack
           #
           # Marks a reminder as complete.
           #
-          # @option options [Object] :reminder
+          # @option options [string] :reminder
           #   The ID of the reminder to be marked as complete.
+          # @option options [string] :team_id
+          #   Encoded team id, required if org token is used.
           # @see https://api.slack.com/methods/reminders.complete
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reminders/reminders.complete.json
           def reminders_complete(options = {})
-            throw ArgumentError.new('Required arguments :reminder missing') if options[:reminder].nil?
+            raise ArgumentError, 'Required arguments :reminder missing' if options[:reminder].nil?
             post('reminders.complete', options)
           end
 
           #
           # Deletes a reminder.
           #
-          # @option options [Object] :reminder
+          # @option options [string] :reminder
           #   The ID of the reminder.
+          # @option options [string] :team_id
+          #   Encoded team id, required if org token is used.
           # @see https://api.slack.com/methods/reminders.delete
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reminders/reminders.delete.json
           def reminders_delete(options = {})
-            throw ArgumentError.new('Required arguments :reminder missing') if options[:reminder].nil?
+            raise ArgumentError, 'Required arguments :reminder missing' if options[:reminder].nil?
             post('reminders.delete', options)
           end
 
           #
           # Gets information about a reminder.
           #
-          # @option options [Object] :reminder
+          # @option options [string] :reminder
           #   The ID of the reminder.
+          # @option options [string] :team_id
+          #   Encoded team id, required if org token is passed.
           # @see https://api.slack.com/methods/reminders.info
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reminders/reminders.info.json
           def reminders_info(options = {})
-            throw ArgumentError.new('Required arguments :reminder missing') if options[:reminder].nil?
+            raise ArgumentError, 'Required arguments :reminder missing' if options[:reminder].nil?
             post('reminders.info', options)
           end
 
           #
           # Lists all reminders created by or for a given user.
           #
+          # @option options [string] :team_id
+          #   Encoded team id, required if org token is passed.
           # @see https://api.slack.com/methods/reminders.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reminders/reminders.list.json
           def reminders_list(options = {})

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -8,38 +9,15 @@ module Slack
           #
           # Starts a Real Time Messaging session.
           #
-          # @option options [Object] :batch_presence_aware
+          # @option options [boolean] :batch_presence_aware
           #   Batch presence deliveries via subscription. Enabling changes the shape of presence_change events. See batch presence.
-          # @option options [Object] :presence_sub
+          # @option options [boolean] :presence_sub
           #   Only deliver presence events when requested by subscription. See presence subscriptions.
           # @see https://api.slack.com/methods/rtm.connect
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/rtm/rtm.connect.json
           def rtm_connect(options = {})
             post('rtm.connect', options)
           end
-
-          #
-          # Starts a Real Time Messaging session.
-          #
-          # @option options [Object] :batch_presence_aware
-          #   Batch presence deliveries via subscription. Enabling changes the shape of presence_change events. See batch presence.
-          # @option options [Object] :include_locale
-          #   Set this to true to receive the locale for users and channels. Defaults to false.
-          # @option options [Object] :mpim_aware
-          #   Returns MPIMs to the client in the API response.
-          # @option options [Object] :no_latest
-          #   Exclude latest timestamps for channels, groups, mpims, and ims. Automatically sets no_unreads to 1.
-          # @option options [Object] :no_unreads
-          #   Skip unread counts for each channel (improves performance).
-          # @option options [Object] :presence_sub
-          #   Only deliver presence events when requested by subscription. See presence subscriptions.
-          # @option options [Object] :simple_latest
-          #   Return timestamp only for latest message object of each channel (improves performance).
-          # @see https://api.slack.com/methods/rtm.start
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/rtm/rtm.start.json
-          def rtm_start(options = {})
-            post('rtm.start', options)
-          end
         end
       end
     end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -8,55 +9,69 @@ module Slack
           #
           # Searches for messages and files matching a query.
           #
-          # @option options [Object] :query
+          # @option options [string] :query
           #   Search query. May contains booleans, etc.
-          # @option options [Object] :highlight
+          # @option options [boolean] :highlight
           #   Pass a value of true to enable query highlight markers (see below).
-          # @option options [Object] :sort
+          # @option options [string] :sort
           #   Return matches sorted by either score or timestamp.
-          # @option options [Object] :sort_dir
+          # @option options [string] :sort_dir
           #   Change sort direction to ascending (asc) or descending (desc).
+          # @option options [string] :team_id
+          #   encoded team id to search in, required if org token is used.
           # @see https://api.slack.com/methods/search.all
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/search/search.all.json
           def search_all(options = {})
-            throw ArgumentError.new('Required arguments :query missing') if options[:query].nil?
+            raise ArgumentError, 'Required arguments :query missing' if options[:query].nil?
             post('search.all', options)
           end
 
           #
           # Searches for files matching a query.
           #
-          # @option options [Object] :query
+          # @option options [string] :query
           #   Search query.
-          # @option options [Object] :highlight
+          # @option options [boolean] :highlight
           #   Pass a value of true to enable query highlight markers (see below).
-          # @option options [Object] :sort
+          # @option options [string] :sort
           #   Return matches sorted by either score or timestamp.
-          # @option options [Object] :sort_dir
+          # @option options [string] :sort_dir
           #   Change sort direction to ascending (asc) or descending (desc).
+          # @option options [string] :team_id
+          #   encoded team id to search in, required if org token is used.
           # @see https://api.slack.com/methods/search.files
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/search/search.files.json
           def search_files(options = {})
-            throw ArgumentError.new('Required arguments :query missing') if options[:query].nil?
+            raise ArgumentError, 'Required arguments :query missing' if options[:query].nil?
             post('search.files', options)
           end
 
           #
           # Searches for messages matching a query.
           #
-          # @option options [Object] :query
+          # @option options [string] :query
           #   Search query.
-          # @option options [Object] :highlight
+          # @option options [string] :cursor
+          #   Use this when getting results with cursormark pagination. For first call send * for subsequent calls, send the value of next_cursor returned in the previous call's results.
+          # @option options [boolean] :highlight
           #   Pass a value of true to enable query highlight markers (see below).
-          # @option options [Object] :sort
+          # @option options [string] :sort
           #   Return matches sorted by either score or timestamp.
-          # @option options [Object] :sort_dir
+          # @option options [string] :sort_dir
           #   Change sort direction to ascending (asc) or descending (desc).
+          # @option options [string] :team_id
+          #   encoded team id to search in, required if org token is used.
           # @see https://api.slack.com/methods/search.messages
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/search/search.messages.json
           def search_messages(options = {})
-            throw ArgumentError.new('Required arguments :query missing') if options[:query].nil?
-            post('search.messages', options)
+            raise ArgumentError, 'Required arguments :query missing' if options[:query].nil?
+            if block_given?
+              Pagination::Cursor.new(self, :search_messages, options).each do |page|
+                yield page
+              end
+            else
+              post('search.messages', options)
+            end
           end
         end
       end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -6,30 +7,32 @@ module Slack
       module Endpoints
         module Stars
           #
-          # Adds a star to an item.
+          # Save an item for later. Formerly known as _adding a star_.
           #
           # @option options [channel] :channel
           #   Channel to add star to, or channel where the message to add star to was posted (used with timestamp).
           # @option options [file] :file
           #   File to add star to.
-          # @option options [Object] :file_comment
+          # @option options [string] :file_comment
           #   File comment to add star to.
-          # @option options [Object] :timestamp
+          # @option options [string] :timestamp
           #   Timestamp of the message to add star to.
           # @see https://api.slack.com/methods/stars.add
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/stars/stars.add.json
           def stars_add(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('stars.add', options)
           end
 
           #
-          # Lists stars for a user.
+          # List a user's saved items, formerly known as _stars_.
           #
-          # @option options [Object] :cursor
+          # @option options [string] :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] :limit
+          # @option options [integer] :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.
+          # @option options [string] :team_id
+          #   encoded team id to list stars in, required if org token is used.
           # @see https://api.slack.com/methods/stars.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/stars/stars.list.json
           def stars_list(options = {})
@@ -43,20 +46,20 @@ module Slack
           end
 
           #
-          # Removes a star from an item.
+          # Removes a saved item (star) from an item.
           #
           # @option options [channel] :channel
           #   Channel to remove star from, or channel where the message to remove star from was posted (used with timestamp).
           # @option options [file] :file
           #   File to remove star from.
-          # @option options [Object] :file_comment
+          # @option options [string] :file_comment
           #   File comment to remove star from.
-          # @option options [Object] :timestamp
+          # @option options [string] :timestamp
           #   Timestamp of the message to remove star from.
           # @see https://api.slack.com/methods/stars.remove
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/stars/stars.remove.json
           def stars_remove(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('stars.remove', options)
           end
         end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -8,8 +9,10 @@ module Slack
           #
           # Gets the access logs for the current team.
           #
-          # @option options [Object] :before
+          # @option options [string] :before
           #   End of time range of logs to include in results (inclusive).
+          # @option options [string] :team_id
+          #   encoded team id to get logs from, required if org token is used.
           # @see https://api.slack.com/methods/team.accessLogs
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team/team.accessLogs.json
           def team_accessLogs(options = {})
@@ -19,6 +22,8 @@ module Slack
           #
           # Gets billable users information for the current team.
           #
+          # @option options [string] :team_id
+          #   encoded team id to get the billable information from, required if org token is used.
           # @option options [user] :user
           #   A user to retrieve the billable information for. Defaults to all users.
           # @see https://api.slack.com/methods/team.billableInfo
@@ -31,6 +36,10 @@ module Slack
           #
           # Gets information about the current team.
           #
+          # @option options [string] :domain
+          #   Query by domain instead of team (only when team is null). This only works for domains in the same enterprise as the querying team token. This also expects the domain to belong to a team and not the enterprise itself.
+          # @option options [string] :team
+          #   Team to get info on, if omitted, will return information about the current team. Will only return team that the authenticated token is allowed to see through external shared channels.
           # @see https://api.slack.com/methods/team.info
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team/team.info.json
           def team_info(options = {})
@@ -40,12 +49,14 @@ module Slack
           #
           # Gets the integration logs for the current team.
           #
-          # @option options [Object] :app_id
+          # @option options [string] :app_id
           #   Filter logs to this Slack app. Defaults to all logs.
-          # @option options [Object] :change_type
+          # @option options [string] :change_type
           #   Filter logs with this change type. Defaults to all logs.
-          # @option options [Object] :service_id
+          # @option options [string] :service_id
           #   Filter logs to this service. Defaults to all logs.
+          # @option options [string] :team_id
+          #   encoded team id to get logs from, required if org token is used.
           # @option options [user] :user
           #   Filter logs generated by this user's actions. Defaults to all logs.
           # @see https://api.slack.com/methods/team.integrationLogs

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module TeamBilling
+          #
+          # Reads a workspace's billing plan information.
+          #
+          # @see https://api.slack.com/methods/team.billing.info
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team.billing/team.billing.info.json
+          def team_billing_info(options = {})
+            post('team.billing.info', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module TeamPreferences
+          #
+          # Retrieve a list of a workspace's team preferences.
+          #
+          # @see https://api.slack.com/methods/team.preferences.list
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team.preferences/team.preferences.list.json
+          def team_preferences_list(options = {})
+            post('team.preferences.list', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -8,7 +9,7 @@ module Slack
           #
           # Retrieve a team's profile.
           #
-          # @option options [Object] :visibility
+          # @option options [string] :visibility
           #   Filter by visibility.
           # @see https://api.slack.com/methods/team.profile.get
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team.profile/team.profile.get.json

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module ToolingTokens
+          #
+          # Exchanges a refresh token for a new app configuration token.
+          #
+          # @option options [string] :refresh_token
+          #   The xoxe refresh token that was issued along with the old app configuration token.
+          # @see https://api.slack.com/methods/tooling.tokens.rotate
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/tooling.tokens/tooling.tokens.rotate.json
+          def tooling_tokens_rotate(options = {})
+            raise ArgumentError, 'Required arguments :refresh_token missing' if options[:refresh_token].nil?
+            post('tooling.tokens.rotate', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -8,20 +9,22 @@ module Slack
           #
           # Create a User Group
           #
-          # @option options [Object] :name
+          # @option options [string] :name
           #   A name for the User Group. Must be unique among User Groups.
-          # @option options [Object] :channels
+          # @option options [array] :channels
           #   A comma separated string of encoded channel IDs for which the User Group uses as a default.
-          # @option options [Object] :description
+          # @option options [string] :description
           #   A short description of the User Group.
-          # @option options [Object] :handle
+          # @option options [string] :handle
           #   A mention handle. Must be unique among channels, users and User Groups.
-          # @option options [Object] :include_count
+          # @option options [boolean] :include_count
           #   Include the number of users in each User Group.
+          # @option options [string] :team_id
+          #   Encoded team id where the user group has to be created, required if org token is used.
           # @see https://api.slack.com/methods/usergroups.create
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups/usergroups.create.json
           def usergroups_create(options = {})
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
+            raise ArgumentError, 'Required arguments :name missing' if options[:name].nil?
             post('usergroups.create', options)
           end
 
@@ -30,38 +33,44 @@ module Slack
           #
           # @option options [Object] :usergroup
           #   The encoded ID of the User Group to disable.
-          # @option options [Object] :include_count
+          # @option options [boolean] :include_count
           #   Include the number of users in the User Group.
+          # @option options [Object] :team_id
+          #   Encoded team id where the user group is, required if org token is used.
           # @see https://api.slack.com/methods/usergroups.disable
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups/usergroups.disable.json
           def usergroups_disable(options = {})
-            throw ArgumentError.new('Required arguments :usergroup missing') if options[:usergroup].nil?
+            raise ArgumentError, 'Required arguments :usergroup missing' if options[:usergroup].nil?
             post('usergroups.disable', options)
           end
 
           #
           # Enable a User Group
           #
-          # @option options [Object] :usergroup
+          # @option options [string] :usergroup
           #   The encoded ID of the User Group to enable.
-          # @option options [Object] :include_count
+          # @option options [boolean] :include_count
           #   Include the number of users in the User Group.
+          # @option options [string] :team_id
+          #   Encoded team id where the user group is, required if org token is used.
           # @see https://api.slack.com/methods/usergroups.enable
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups/usergroups.enable.json
           def usergroups_enable(options = {})
-            throw ArgumentError.new('Required arguments :usergroup missing') if options[:usergroup].nil?
+            raise ArgumentError, 'Required arguments :usergroup missing' if options[:usergroup].nil?
             post('usergroups.enable', options)
           end
 
           #
           # List all User Groups for a team
           #
-          # @option options [Object] :include_count
+          # @option options [boolean] :include_count
           #   Include the number of users in each User Group.
-          # @option options [Object] :include_disabled
+          # @option options [boolean] :include_disabled
           #   Include disabled User Groups.
-          # @option options [Object] :include_users
+          # @option options [boolean] :include_users
           #   Include the list of users for each User Group.
+          # @option options [string] :team_id
+          #   encoded team id to list user groups in, required if org token is used.
           # @see https://api.slack.com/methods/usergroups.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups/usergroups.list.json
           def usergroups_list(options = {})
@@ -73,20 +82,22 @@ module Slack
           #
           # @option options [Object] :usergroup
           #   The encoded ID of the User Group to update.
-          # @option options [Object] :channels
+          # @option options [array] :channels
           #   A comma separated string of encoded channel IDs for which the User Group uses as a default.
-          # @option options [Object] :description
+          # @option options [string] :description
           #   A short description of the User Group.
-          # @option options [Object] :handle
+          # @option options [string] :handle
           #   A mention handle. Must be unique among channels, users and User Groups.
-          # @option options [Object] :include_count
+          # @option options [boolean] :include_count
           #   Include the number of users in the User Group.
-          # @option options [Object] :name
+          # @option options [string] :name
           #   A name for the User Group. Must be unique among User Groups.
+          # @option options [Object] :team_id
+          #   encoded team id where the user group exists, required if org token is used.
           # @see https://api.slack.com/methods/usergroups.update
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups/usergroups.update.json
           def usergroups_update(options = {})
-            throw ArgumentError.new('Required arguments :usergroup missing') if options[:usergroup].nil?
+            raise ArgumentError, 'Required arguments :usergroup missing' if options[:usergroup].nil?
             post('usergroups.update', options)
           end
         end