slack-ruby-client 0.14.6 → 1.0.0

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

@@ -9,20 +9,38 @@ module Slack
           #
           # Exchanges a temporary OAuth verifier code for an access token.
           #
-          # @option options [Object] :code
-          #   The code param returned via the OAuth callback.
-          # @option options [Object] :client_id
+          # @option options [string] :client_id
           #   Issued when you created your application.
-          # @option options [Object] :client_secret
+          # @option options [string] :client_secret
           #   Issued when you created your application.
-          # @option options [Object] :redirect_uri
+          # @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/oauth.v2.access
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/oauth.v2/oauth.v2.access.json
           def oauth_v2_access(options = {})
-            throw ArgumentError.new('Required arguments :code missing') if options[:code].nil?
             post('oauth.v2.access', options)
           end
+
+          #
+          # Exchanges a legacy access token for a new expiring access token and refresh token
+          #
+          # @option options [string] :client_id
+          #   Issued when you created your application.
+          # @option options [string] :client_secret
+          #   Issued when you created your application.
+          # @see https://api.slack.com/methods/oauth.v2.exchange
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/oauth.v2/oauth.v2.exchange.json
+          def oauth_v2_exchange(options = {})
+            throw ArgumentError.new('Required arguments :client_id missing') if options[:client_id].nil?
+            throw ArgumentError.new('Required arguments :client_secret missing') if options[:client_secret].nil?
+            post('oauth.v2.exchange', options)
+          end
         end
       end
     end

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,15 +10,14 @@ 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: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('pins.add', options)
           end
 
@@ -31,7 +30,7 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/pins/pins.list.json
           def pins_list(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            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('pins.list', options)
           end
 
@@ -40,17 +39,13 @@ 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
           def pins_remove(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            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('pins.remove', options)
           end
         end

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
@@ -21,7 +21,7 @@ module Slack
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
             throw ArgumentError.new('Required arguments :timestamp missing') if options[:timestamp].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('reactions.add', options)
           end
 
@@ -32,28 +32,30 @@ module Slack
           #   Channel where the message to get reactions for was posted.
           # @option options [file] :file
           #   File to get reactions for.
-          # @option options [Object] :file_comment
+          # @option options [string] :file_comment
           #   File comment to get reactions for.
-          # @option options [Object] :full
+          # @option options [boolean] :full
           #   If true always return the complete reaction list.
-          # @option options [Object] :timestamp
+          # @option options [string] :timestamp
           #   Timestamp of the message to get reactions for.
           # @see https://api.slack.com/methods/reactions.get
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reactions/reactions.get.json
           def reactions_get(options = {})
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('reactions.get', options)
           end
 
           #
           # Lists reactions made by a user.
           #
-          # @option options [Object] :cursor
+          # @option options [string] :cursor
           #   Parameter for pagination. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first "page" of the collection. See pagination for more details.
-          # @option options [Object] :full
+          # @option options [boolean] :full
           #   If true always return the complete reaction list.
-          # @option options [Object] :limit
+          # @option options [integer] :limit
           #   The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached.
+          # @option options [string] :team_id
+          #   encoded team id to list reactions in, required if org token is used.
           # @option options [user] :user
           #   Show reactions made by this user. Defaults to the authed user.
           # @see https://api.slack.com/methods/reactions.list
@@ -72,21 +74,21 @@ module Slack
           #
           # Removes a reaction from an item.
           #
-          # @option options [Object] :name
+          # @option options [string] :name
           #   Reaction (emoji) name.
           # @option options [channel] :channel
           #   Channel where the message to remove reaction from was posted.
           # @option options [file] :file
           #   File to remove reaction from.
-          # @option options [Object] :file_comment
+          # @option options [string] :file_comment
           #   File comment to remove reaction from.
-          # @option options [Object] :timestamp
+          # @option options [string] :timestamp
           #   Timestamp of the message to remove reaction from.
           # @see https://api.slack.com/methods/reactions.remove
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reactions/reactions.remove.json
           def reactions_remove(options = {})
             throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('reactions.remove', options)
           end
         end

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

@@ -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,30 +7,32 @@ module Slack
       module Endpoints
         module Stars
           #
-          # Adds a star to an item.
+          # Save an item for later. Formerly known as _adding a star_.
           #
           # @option options [channel] :channel
           #   Channel to add star to, or channel where the message to add star to was posted (used with timestamp).
           # @option options [file] :file
           #   File to add star to.
-          # @option options [Object] :file_comment
+          # @option options [string] :file_comment
           #   File comment to add star to.
-          # @option options [Object] :timestamp
+          # @option options [string] :timestamp
           #   Timestamp of the message to add star to.
           # @see https://api.slack.com/methods/stars.add
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/stars/stars.add.json
           def stars_add(options = {})
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('stars.add', options)
           end
 
           #
-          # Lists stars for a user.
+          # List a user's saved items, formerly known as _stars_.
           #
-          # @option options [Object] :cursor
+          # @option options [string] :cursor
           #   Parameter for pagination. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first "page" of the collection. See pagination for more details.
-          # @option options [Object] :limit
+          # @option options [integer] :limit
           #   The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached.
+          # @option options [string] :team_id
+          #   encoded team id to list stars in, required if org token is used.
           # @see https://api.slack.com/methods/stars.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/stars/stars.list.json
           def stars_list(options = {})
@@ -44,20 +46,20 @@ module Slack
           end
 
           #
-          # Removes a star from an item.
+          # Removes a saved item (star) from an item.
           #
           # @option options [channel] :channel
           #   Channel to remove star from, or channel where the message to remove star from was posted (used with timestamp).
           # @option options [file] :file
           #   File to remove star from.
-          # @option options [Object] :file_comment
+          # @option options [string] :file_comment
           #   File comment to remove star from.
-          # @option options [Object] :timestamp
+          # @option options [string] :timestamp
           #   Timestamp of the message to remove star from.
           # @see https://api.slack.com/methods/stars.remove
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/stars/stars.remove.json
           def stars_remove(options = {})
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('stars.remove', options)
           end
         end

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

@@ -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