slack-ruby-client 0.7.2 → 1.0.0

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
@@ -6,17 +7,37 @@ module Slack
       module Endpoints
         module Rtm
           #
-          # This method starts a Real Time Messaging API session. Refer to the
-          # RTM API documentation for full details on how to use the RTM API.
+          # Starts a Real Time Messaging session.
           #
-          # @option options [Object] :simple_latest
-          #   Return timestamp only for latest message object of each channel (improves performance).
-          # @option options [Object] :no_unreads
-          #   Skip unread counts for each channel (improves performance).
-          # @option options [Object] :mpim_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 [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
+
+          #
+          # Deprecated: Starts a Real Time Messaging session. Use rtm.connect instead.
+          #
+          # @option options [boolean] :batch_presence_aware
+          #   Batch presence deliveries via subscription. Enabling changes the shape of presence_change events. See batch presence.
+          # @option options [boolean] :include_locale
+          #   Set this to true to receive the locale for users and channels. Defaults to false.
+          # @option options [boolean] :mpim_aware
           #   Returns MPIMs to the client in the API response.
+          # @option options [boolean] :no_latest
+          #   Exclude latest timestamps for channels, groups, mpims, and ims. Automatically sets no_unreads to 1.
+          # @option options [boolean] :no_unreads
+          #   Skip unread counts for each channel (improves performance).
+          # @option options [boolean] :presence_sub
+          #   Only deliver presence events when requested by subscription. See presence subscriptions.
+          # @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/dblock/slack-api-ref/blob/master/methods/rtm/rtm.start.json
+          # @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

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
@@ -6,57 +7,71 @@ module Slack
       module Endpoints
         module Search
           #
-          # This method allows to to search both messages and files in a single call.
+          # 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] :sort
+          # @option options [boolean] :highlight
+          #   Pass a value of true to enable query highlight markers (see below).
+          # @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] :highlight
-          #   Pass a value of 1 to enable query highlight markers (see below).
+          # @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/dblock/slack-api-ref/blob/master/methods/search/search.all.json
+          # @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?
             post('search.all', options)
           end
 
           #
-          # This method returns files matching a search query.
+          # Searches for files matching a query.
           #
-          # @option options [Object] :query
-          #   Search query. May contain booleans, etc.
-          # @option options [Object] :sort
+          # @option options [string] :query
+          #   Search query.
+          # @option options [boolean] :highlight
+          #   Pass a value of true to enable query highlight markers (see below).
+          # @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] :highlight
-          #   Pass a value of 1 to enable query highlight markers (see below).
+          # @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/dblock/slack-api-ref/blob/master/methods/search/search.files.json
+          # @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?
             post('search.files', options)
           end
 
           #
-          # This method returns messages matching a search query.
+          # Searches for messages matching a query.
           #
-          # @option options [Object] :query
-          #   Search query. May contains booleans, etc.
-          # @option options [Object] :sort
+          # @option options [string] :query
+          #   Search query.
+          # @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 [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] :highlight
-          #   Pass a value of 1 to enable query highlight markers (see below).
+          # @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/dblock/slack-api-ref/blob/master/methods/search/search.messages.json
+          # @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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -6,52 +7,59 @@ module Slack
       module Endpoints
         module Stars
           #
-          # This method adds a star to an item (message, file, file comment, channel, private group, or DM) on behalf of the authenticated user.
-          # One of file, file_comment, channel, or the combination of channel and timestamp must be specified.
+          # 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 [channel] :channel
-          #   Channel to add star to, or channel where the message to add star to was posted (used with timestamp).
-          # @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/dblock/slack-api-ref/blob/master/methods/stars/stars.add.json
+          # @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
 
           #
-          # This method lists the items starred by a user.
+          # List a user's saved items, formerly known as _stars_.
           #
-          # @option options [user] :user
-          #   Show stars by this user. Defaults to the authed user.
+          # @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 [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/dblock/slack-api-ref/blob/master/methods/stars/stars.list.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/stars/stars.list.json
           def stars_list(options = {})
-            options = options.merge(user: users_id(options)['user']['id']) if options[:user]
-            post('stars.list', options)
+            if block_given?
+              Pagination::Cursor.new(self, :stars_list, options).each do |page|
+                yield page
+              end
+            else
+              post('stars.list', options)
+            end
           end
 
           #
-          # This method removes a star from an item (message, file, file comment, channel, private group, or DM) on behalf of the authenticated user.
-          # One of file, file_comment, channel, or the combination of channel and timestamp must be specified.
+          # 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 [channel] :channel
-          #   Channel to remove star from, or channel where the message to remove star from was posted (used with timestamp).
-          # @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/dblock/slack-api-ref/blob/master/methods/stars/stars.remove.json
+          # @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
@@ -6,36 +7,58 @@ module Slack
       module Endpoints
         module Team
           #
-          # This method is used to get the access logs for users on a team.
+          # Gets the access logs for the current team.
           #
+          # @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/dblock/slack-api-ref/blob/master/methods/team/team.accessLogs.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team/team.accessLogs.json
           def team_accessLogs(options = {})
             post('team.accessLogs', options)
           end
 
           #
-          # This method provides information about your team.
+          # 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
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team/team.billableInfo.json
+          def team_billableInfo(options = {})
+            options = options.merge(user: users_id(options)['user']['id']) if options[:user]
+            post('team.billableInfo', options)
+          end
+
+          #
+          # Gets information about the current 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/dblock/slack-api-ref/blob/master/methods/team/team.info.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team/team.info.json
           def team_info(options = {})
             post('team.info', options)
           end
 
           #
-          # This method lists the integration activity logs for a team, including when integrations are added, modified and removed. This method can only be called by Admins.
+          # Gets the integration logs for the current team.
           #
-          # @option options [Object] :service_id
-          #   Filter logs to this service. Defaults to all logs.
-          # @option options [Object] :app_id
+          # @option options [string] :app_id
           #   Filter logs to this Slack app. Defaults to all logs.
+          # @option options [string] :change_type
+          #   Filter logs with this change type. Defaults to all logs.
+          # @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.
-          # @option options [Object] :change_type
-          #   Filter logs with this change type. Defaults to all logs.
           # @see https://api.slack.com/methods/team.integrationLogs
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/team/team.integrationLogs.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team/team.integrationLogs.json
           def team_integrationLogs(options = {})
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             post('team.integrationLogs', options)

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

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module TeamProfile
+          #
+          # Retrieve a team's profile.
+          #
+          # @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
+          def team_profile_get(options = {})
+            post('team.profile.get', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -6,85 +7,95 @@ module Slack
       module Endpoints
         module Usergroups
           #
-          # This method is used to create a User Group.
+          # 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] :handle
-          #   A mention handle. Must be unique among channels, users and User Groups.
-          # @option options [Object] :description
-          #   A short description of the User Group.
-          # @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] :include_count
+          # @option options [string] :description
+          #   A short description of the User Group.
+          # @option options [string] :handle
+          #   A mention handle. Must be unique among channels, users and User Groups.
+          # @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/dblock/slack-api-ref/blob/master/methods/usergroups/usergroups.create.json
+          # @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?
             post('usergroups.create', options)
           end
 
           #
-          # This method disables an existing User Group.
+          # Disable an existing User Group
           #
           # @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/dblock/slack-api-ref/blob/master/methods/usergroups/usergroups.disable.json
+          # @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?
             post('usergroups.disable', options)
           end
 
           #
-          # This method enables a User Group which was previously disabled.
+          # 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/dblock/slack-api-ref/blob/master/methods/usergroups/usergroups.enable.json
+          # @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?
             post('usergroups.enable', options)
           end
 
           #
-          # This method returns a list of all User Groups in the team. This can optionally include disabled User Groups.
+          # List all User Groups for a team
           #
-          # @option options [Object] :include_disabled
-          #   Include disabled User Groups.
-          # @option options [Object] :include_count
+          # @option options [boolean] :include_count
           #   Include the number of users in each User Group.
-          # @option options [Object] :include_users
+          # @option options [boolean] :include_disabled
+          #   Include disabled User Groups.
+          # @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/dblock/slack-api-ref/blob/master/methods/usergroups/usergroups.list.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups/usergroups.list.json
           def usergroups_list(options = {})
             post('usergroups.list', options)
           end
 
           #
-          # This method updates the properties of an existing User Group.
+          # Update an existing User Group
           #
           # @option options [Object] :usergroup
           #   The encoded ID of the User Group to update.
-          # @option options [Object] :name
-          #   A name for the User Group. Must be unique among User Groups.
-          # @option options [Object] :handle
-          #   A mention handle. Must be unique among channels, users and User Groups.
-          # @option options [Object] :description
-          #   A short description of the User Group.
-          # @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] :include_count
+          # @option options [string] :description
+          #   A short description of the User Group.
+          # @option options [string] :handle
+          #   A mention handle. Must be unique among channels, users and User Groups.
+          # @option options [boolean] :include_count
           #   Include the number of users in the User Group.
+          # @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/dblock/slack-api-ref/blob/master/methods/usergroups/usergroups.update.json
+          # @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?
             post('usergroups.update', options)

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -6,30 +7,34 @@ module Slack
       module Endpoints
         module UsergroupsUsers
           #
-          # This method returns a list of all users within a User Group.
+          # 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/dblock/slack-api-ref/blob/master/methods/usergroups.users/usergroups.users.list.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups.users/usergroups.users.list.json
           def usergroups_users_list(options = {})
             throw ArgumentError.new('Required arguments :usergroup missing') if options[:usergroup].nil?
             post('usergroups.users.list', options)
           end
 
           #
-          # This method updates the list of users that belong to a User Group. This method replaces all users in a User Group with the list of users provided in the users parameter.
+          # 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/dblock/slack-api-ref/blob/master/methods/usergroups.users/usergroups.users.update.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups.users/usergroups.users.update.json
           def usergroups_users_update(options = {})
             throw ArgumentError.new('Required arguments :usergroup missing') if options[:usergroup].nil?
             throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?