slack-ruby-client 0.15.0 → 1.0.0

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

@@ -10,14 +10,13 @@ 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 = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :timestamp missing') if options[:timestamp].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('pins.add', options)
           end
@@ -40,11 +39,7 @@ module Slack
           #
           # @option options [channel] :channel
           #   Channel where the item is pinned to.
-          # @option options [file] :file
-          #   File to un-pin.
-          # @option options [Object] :file_comment
-          #   File comment to un-pin.
-          # @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,12 +48,14 @@ 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 [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
@@ -72,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,14 +9,16 @@ 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 = {})
@@ -27,14 +29,16 @@ 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 [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 = {})
@@ -45,19 +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 [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,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 = {})
@@ -20,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
@@ -32,7 +36,7 @@ module Slack
           #
           # Gets information about the current team.
           #
-          # @option options [Object] :team
+          # @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
@@ -43,12 +47,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

@@ -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,16 +9,18 @@ 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 = {})
@@ -31,8 +33,10 @@ 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 = {})
@@ -43,10 +47,12 @@ 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 [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 = {})
@@ -57,12 +63,14 @@ 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 [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 = {})
@@ -74,16 +82,18 @@ 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 = {})

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

@@ -9,10 +9,12 @@ 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 [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
           def usergroups_users_list(options = {})
@@ -23,12 +25,14 @@ 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 [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
           def usergroups_users_update(options = {})