slack-ruby-client 0.11.0 → 2.7.0

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -8,14 +9,16 @@ module Slack
           #
           # For Enterprise Grid workspaces, map local user IDs to global user IDs
           #
-          # @option options [Object] :users
+          # @option options [array] :users
           #   A comma-separated list of user ids, up to 400 per request.
-          # @option options [Object] :to_old
+          # @option options [string] :team_id
+          #   Specify team_id starts with T in case of Org Token.
+          # @option options [boolean] :to_old
           #   Specify true to convert W global user IDs to workspace-specific U IDs. Defaults to false.
           # @see https://api.slack.com/methods/migration.exchange
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/migration/migration.exchange.json
           def migration_exchange(options = {})
-            throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?
+            raise ArgumentError, 'Required arguments :users missing' if options[:users].nil?
             post('migration.exchange', options)
           end
         end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -6,46 +7,23 @@ module Slack
       module Endpoints
         module Oauth
           #
-          # Exchanges a temporary OAuth code for an API token.
+          # Exchanges a temporary OAuth verifier code for an access token.
           #
-          # @option options [Object] :client_id
-          #   Issued when you created your application.
-          # @option options [Object] :client_secret
-          #   Issued when you created your application.
-          # @option options [Object] :code
+          # @option options [string] :client_id
+          #   Issued when you created your application. If possible, avoid sending client_id and client_secret as parameters in your request and instead supply the Client ID and Client Secret using the HTTP Basic authentication scheme.
+          # @option options [string] :client_secret
+          #   Issued when you created your application. If possible, avoid sending client_id and client_secret as parameters in your request and instead supply the Client ID and Client Secret using the HTTP Basic authentication scheme.
+          # @option options [string] :code
           #   The code param returned via the OAuth callback.
-          # @option options [Object] :redirect_uri
+          # @option options [string] :redirect_uri
           #   This must match the originally submitted URI (if one was sent).
+          # @option options [boolean] :single_channel
+          #   Request the user to add your app only to a single channel. Only valid with a legacy workspace app.
           # @see https://api.slack.com/methods/oauth.access
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/oauth/oauth.access.json
           def oauth_access(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?
-            throw ArgumentError.new('Required arguments :code missing') if options[:code].nil?
             post('oauth.access', options)
           end
-
-          #
-          # Exchanges a temporary OAuth verifier code for a workspace token.
-          #
-          # @option options [Object] :client_id
-          #   Issued when you created your application.
-          # @option options [Object] :client_secret
-          #   Issued when you created your application.
-          # @option options [Object] :code
-          #   The code param returned via the OAuth callback.
-          # @option options [Object] :redirect_uri
-          #   This must match the originally submitted URI (if one was sent).
-          # @option options [Object] :single_channel
-          #   Request the user to add your app only to a single channel.
-          # @see https://api.slack.com/methods/oauth.token
-          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/oauth/oauth.token.json
-          def oauth_token(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?
-            throw ArgumentError.new('Required arguments :code missing') if options[:code].nil?
-            post('oauth.token', options)
-          end
         end
       end
     end

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

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module OauthV2
+          #
+          # Exchanges a temporary OAuth verifier code for an access token.
+          #
+          # @option options [string] :client_id
+          #   Issued when you created your application. If possible, avoid sending client_id and client_secret as parameters in your request and instead supply the Client ID and Client Secret using the HTTP Basic authentication scheme.
+          # @option options [string] :client_secret
+          #   Issued when you created your application. If possible, avoid sending client_id and client_secret as parameters in your request and instead supply the Client ID and Client Secret using the HTTP Basic authentication scheme.
+          # @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 = {})
+            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 = {})
+            raise ArgumentError, 'Required arguments :client_id missing' if options[:client_id].nil?
+            raise ArgumentError, 'Required arguments :client_secret missing' if options[:client_secret].nil?
+            post('oauth.v2.exchange', options)
+          end
+        end
+      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 [enum] :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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -9,18 +10,14 @@ module Slack
           # Pins an item to a channel.
           #
           # @option options [channel] :channel
-          #   Channel to pin the item in.
-          # @option options [file] :file
-          #   File to pin.
-          # @option options [Object] :file_comment
-          #   File comment to pin.
-          # @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?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('pins.add', options)
           end
 
@@ -32,8 +29,8 @@ module Slack
           # @see https://api.slack.com/methods/pins.list
           # @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]
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('pins.list', options)
           end
 
@@ -42,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]
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -8,21 +9,19 @@ module Slack
           #
           # Adds a reaction to an item.
           #
-          # @option options [Object] :name
-          #   Reaction (emoji) name.
           # @option options [channel] :channel
           #   Channel where the message to add reaction to was posted.
-          # @option options [file] :file
-          #   File to add reaction to.
-          # @option options [Object] :file_comment
-          #   File comment to add reaction to.
-          # @option options [Object] :timestamp
+          # @option options [string] :name
+          #   Reaction (emoji) name.
+          # @option options [string] :timestamp
           #   Timestamp of the message to add reaction to.
           # @see https://api.slack.com/methods/reactions.add
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reactions/reactions.add.json
           def reactions_add(options = {})
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
+            raise ArgumentError, 'Required arguments :name missing' if options[:name].nil?
+            raise ArgumentError, 'Required arguments :timestamp missing' if options[:timestamp].nil?
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('reactions.add', options)
           end
 
@@ -33,51 +32,63 @@ 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] :full
+          # @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 [boolean] :full
           #   If true always return the complete reaction list.
+          # @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
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reactions/reactions.list.json
           def reactions_list(options = {})
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
-            post('reactions.list', options)
+            if block_given?
+              Pagination::Cursor.new(self, :reactions_list, options).each do |page|
+                yield page
+              end
+            else
+              post('reactions.list', options)
+            end
           end
 
           #
           # Removes a reaction from an item.
           #
-          # @option options [Object] :name
+          # @option options [string] :name
           #   Reaction (emoji) name.
           # @option options [channel] :channel
           #   Channel where the message to remove reaction from was posted.
           # @option options [file] :file
           #   File to remove reaction from.
-          # @option options [Object] :file_comment
+          # @option options [string] :file_comment
           #   File comment to remove reaction from.
-          # @option options [Object] :timestamp
+          # @option options [string] :timestamp
           #   Timestamp of the message to remove reaction from.
           # @see https://api.slack.com/methods/reactions.remove
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reactions/reactions.remove.json
           def reactions_remove(options = {})
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            raise ArgumentError, 'Required arguments :name missing' if options[:name].nil?
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('reactions.remove', options)
           end
         end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -8,17 +9,21 @@ module Slack
           #
           # Creates a reminder.
           #
-          # @option options [Object] :text
+          # @option options [string] :text
           #   The content of the reminder.
-          # @option options [Object] :time
-          #   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 [string] :time
+          #   Can also take a type of integer. 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.
+          #   No longer supported - reminders cannot be set for other users. Previously, was the user who would receive the reminder.
           # @see https://api.slack.com/methods/reminders.add
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reminders/reminders.add.json
           def reminders_add(options = {})
-            throw ArgumentError.new('Required arguments :text missing') if options[:text].nil?
-            throw ArgumentError.new('Required arguments :time missing') if options[:time].nil?
+            raise ArgumentError, 'Required arguments :text missing' if options[:text].nil?
+            raise ArgumentError, 'Required arguments :time missing' if options[:time].nil?
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             post('reminders.add', options)
           end
@@ -26,42 +31,50 @@ module Slack
           #
           # Marks a reminder as complete.
           #
-          # @option options [Object] :reminder
+          # @option options [string] :reminder
           #   The ID of the reminder to be marked as complete.
+          # @option options [string] :team_id
+          #   Encoded team id, required if org token is used.
           # @see https://api.slack.com/methods/reminders.complete
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reminders/reminders.complete.json
           def reminders_complete(options = {})
-            throw ArgumentError.new('Required arguments :reminder missing') if options[:reminder].nil?
+            raise ArgumentError, 'Required arguments :reminder missing' if options[:reminder].nil?
             post('reminders.complete', options)
           end
 
           #
           # Deletes a reminder.
           #
-          # @option options [Object] :reminder
+          # @option options [string] :reminder
           #   The ID of the reminder.
+          # @option options [string] :team_id
+          #   Encoded team id, required if org token is used.
           # @see https://api.slack.com/methods/reminders.delete
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reminders/reminders.delete.json
           def reminders_delete(options = {})
-            throw ArgumentError.new('Required arguments :reminder missing') if options[:reminder].nil?
+            raise ArgumentError, 'Required arguments :reminder missing' if options[:reminder].nil?
             post('reminders.delete', options)
           end
 
           #
           # Gets information about a reminder.
           #
-          # @option options [Object] :reminder
+          # @option options [string] :reminder
           #   The ID of the reminder.
+          # @option options [string] :team_id
+          #   Encoded team id, required if org token is passed.
           # @see https://api.slack.com/methods/reminders.info
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reminders/reminders.info.json
           def reminders_info(options = {})
-            throw ArgumentError.new('Required arguments :reminder missing') if options[:reminder].nil?
+            raise ArgumentError, 'Required arguments :reminder missing' if options[:reminder].nil?
             post('reminders.info', options)
           end
 
           #
           # Lists all reminders created by or for a given user.
           #
+          # @option options [string] :team_id
+          #   Encoded team id, required if org token is passed.
           # @see https://api.slack.com/methods/reminders.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/reminders/reminders.list.json
           def reminders_list(options = {})

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

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

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

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