slack-ruby-client 0.16.0 → 1.1.0

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

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module OpenidConnect
+          #
+          # Exchanges a temporary OAuth verifier code for an access token for Sign in with Slack.
+          #
+          # @option options [string] :client_id
+          #   Issued when you created your application.
+          # @option options [string] :client_secret
+          #   Issued when you created your application.
+          # @option options [string] :code
+          #   The code param returned via the OAuth callback.
+          # @option options [string] :grant_type
+          #   The grant_type param as described in the OAuth spec.
+          # @option options [string] :redirect_uri
+          #   This must match the originally submitted URI (if one was sent).
+          # @option options [string] :refresh_token
+          #   The refresh_token param as described in the OAuth spec.
+          # @see https://api.slack.com/methods/openid.connect.token
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/openid.connect/openid.connect.token.json
+          def openid_connect_token(options = {})
+            post('openid.connect.token', options)
+          end
+
+          #
+          # Get the identity of a user who has authorized Sign in with Slack.
+          #
+          # @see https://api.slack.com/methods/openid.connect.userInfo
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/openid.connect/openid.connect.userInfo.json
+          def openid_connect_userInfo(options = {})
+            post('openid.connect.userInfo', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -10,9 +10,9 @@ module Slack
           # Pins an item to a channel.
           #
           # @option options [channel] :channel
-          #   Channel to pin the item in.
-          # @option options [Object] :timestamp
-          #   Timestamp of the message to pin.
+          #   Channel to pin the messsage to. You must also include a timestamp when pinning messages.
+          # @option options [string] :timestamp
+          #   Timestamp of the message to pin. You must also include the channel.
           # @see https://api.slack.com/methods/pins.add
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/pins/pins.add.json
           def pins_add(options = {})
@@ -39,7 +39,7 @@ module Slack
           #
           # @option options [channel] :channel
           #   Channel where the item is pinned to.
-          # @option options [Object] :timestamp
+          # @option options [string] :timestamp
           #   Timestamp of the message to un-pin.
           # @see https://api.slack.com/methods/pins.remove
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/pins/pins.remove.json

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

@@ -11,9 +11,9 @@ module Slack
           #
           # @option options [channel] :channel
           #   Channel where the message to add reaction to was posted.
-          # @option options [Object] :name
+          # @option options [string] :name
           #   Reaction (emoji) name.
-          # @option options [Object] :timestamp
+          # @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
@@ -32,11 +32,11 @@ 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
@@ -48,13 +48,13 @@ module Slack
           #
           # 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 [Object] :team_id
+          # @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.
@@ -74,15 +74,15 @@ 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

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

@@ -9,10 +9,14 @@ 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
@@ -27,8 +31,10 @@ 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 = {})
@@ -39,8 +45,10 @@ module Slack
           #
           # 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 = {})
@@ -51,8 +59,10 @@ module Slack
           #
           # 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 = {})
@@ -63,6 +73,8 @@ module Slack
           #
           # 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

@@ -9,9 +9,9 @@ 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
@@ -20,21 +20,21 @@ module Slack
           end
 
           #
-          # Starts a Real Time Messaging session.
+          # Deprecated: Starts a Real Time Messaging session. Use rtm.connect instead.
           #
-          # @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] :include_locale
+          # @option options [boolean] :include_locale
           #   Set this to true to receive the locale for users and channels. Defaults to false.
-          # @option options [Object] :mpim_aware
+          # @option options [boolean] :mpim_aware
           #   Returns MPIMs to the client in the API response.
-          # @option options [Object] :no_latest
+          # @option options [boolean] :no_latest
           #   Exclude latest timestamps for channels, groups, mpims, and ims. Automatically sets no_unreads to 1.
-          # @option options [Object] :no_unreads
+          # @option options [boolean] :no_unreads
           #   Skip unread counts for each channel (improves performance).
-          # @option options [Object] :presence_sub
+          # @option options [boolean] :presence_sub
           #   Only deliver presence events when requested by subscription. See presence subscriptions.
-          # @option options [Object] :simple_latest
+          # @option options [boolean] :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

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

@@ -9,15 +9,15 @@ 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 [Object] :team_id
+          # @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
@@ -29,15 +29,15 @@ module Slack
           #
           # 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 [Object] :team_id
+          # @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
@@ -49,21 +49,29 @@ module Slack
           #
           # 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 [Object] :team_id
+          # @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)
+            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

@@ -7,15 +7,15 @@ 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
@@ -25,12 +25,14 @@ module Slack
           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 = {})
@@ -44,15 +46,15 @@ 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

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

@@ -9,9 +9,9 @@ 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 [Object] :team_id
+          # @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
@@ -22,7 +22,7 @@ module Slack
           #
           # Gets billable users information for the current team.
           #
-          # @option options [Object] :team_id
+          # @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.
@@ -36,7 +36,9 @@ module Slack
           #
           # Gets information about the current team.
           #
-          # @option options [Object] :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
@@ -47,13 +49,13 @@ 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 [Object] :team_id
+          # @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.

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

@@ -9,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 = {})
+            throw ArgumentError.new('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

@@ -9,17 +9,17 @@ 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 [Object] :team_id
+          # @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
@@ -33,7 +33,7 @@ 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.
@@ -47,11 +47,11 @@ module Slack
           #
           # 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 [Object] :team_id
+          # @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
@@ -63,13 +63,13 @@ module Slack
           #
           # 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 [Object] :team_id
+          # @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
@@ -82,15 +82,15 @@ 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.

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

@@ -9,11 +9,11 @@ module Slack
           #
           # List all users in a User Group
           #
-          # @option options [Object] :usergroup
+          # @option options [string] :usergroup
           #   The encoded ID of the User Group to update.
-          # @option options [Object] :include_disabled
+          # @option options [boolean] :include_disabled
           #   Allow results that involve disabled User Groups.
-          # @option options [Object] :team_id
+          # @option options [string] :team_id
           #   encoded team id where the user group exists, required if org token is used.
           # @see https://api.slack.com/methods/usergroups.users.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups.users/usergroups.users.list.json
@@ -25,13 +25,13 @@ module Slack
           #
           # Update the list of users for a User Group
           #
-          # @option options [Object] :usergroup
+          # @option options [string] :usergroup
           #   The encoded ID of the User Group to update.
-          # @option options [Object] :users
+          # @option options [array] :users
           #   A comma separated string of encoded user IDs that represent the entire list of users for the User Group.
-          # @option options [Object] :include_count
+          # @option options [boolean] :include_count
           #   Include the number of users in the User Group.
-          # @option options [Object] :team_id
+          # @option options [string] :team_id
           #   encoded team id where the user group exists, required if org token is used.
           # @see https://api.slack.com/methods/usergroups.users.update
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups.users/usergroups.users.update.json