slack-ruby-client 0.9.0 → 0.11.0

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

@@ -6,12 +6,12 @@ module Slack
       module Endpoints
         module Groups
           #
-          # This method archives a private channel.
+          # Archives a private channel.
           #
           # @option options [group] :channel
           #   Private channel to archive.
           # @see https://api.slack.com/methods/groups.archive
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.archive.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.archive.json
           def groups_archive(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
@@ -19,39 +19,26 @@ module Slack
           end
 
           #
-          # This method closes a private channel.
-          #
-          # @option options [group] :channel
-          #   Private channel to close.
-          # @see https://api.slack.com/methods/groups.close
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.close.json
-          def groups_close(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
-            post('groups.close', options)
-          end
-
-          #
-          # This method creates a private channel.
+          # Creates a private channel.
           #
           # @option options [Object] :name
           #   Name of private channel to create.
           # @option options [Object] :validate
           #   Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.
           # @see https://api.slack.com/methods/groups.create
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.create.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.create.json
           def groups_create(options = {})
             throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
             post('groups.create', options)
           end
 
           #
-          # This method takes an existing private channel and performs the following steps:
+          # Clones and archives a private channel.
           #
           # @option options [group] :channel
           #   Private channel to clone and archive.
           # @see https://api.slack.com/methods/groups.createChild
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.createChild.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.createChild.json
           def groups_createChild(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
@@ -59,22 +46,20 @@ module Slack
           end
 
           #
-          # This method returns a portion of messages/events from the specified private channel.
-          # To read the entire history for a private channel, call the method with no latest or
-          # oldest arguments, and then continue paging using the instructions below.
+          # Fetches history of messages and events from a private channel.
           #
           # @option options [group] :channel
           #   Private channel to fetch history for.
+          # @option options [Object] :inclusive
+          #   Include messages with latest or oldest timestamp in results.
           # @option options [timestamp] :latest
           #   End of time range of messages to include in results.
           # @option options [timestamp] :oldest
           #   Start of time range of messages to include in results.
-          # @option options [Object] :inclusive
-          #   Include messages with latest or oldest timestamp in results.
           # @option options [Object] :unreads
           #   Include unread_count_display in the output?.
           # @see https://api.slack.com/methods/groups.history
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.history.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.history.json
           def groups_history(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
@@ -82,12 +67,14 @@ module Slack
           end
 
           #
-          # This method returns information about a private channel.
+          # Gets information about a private channel.
           #
           # @option options [group] :channel
           #   Private channel to get info on.
+          # @option options [Object] :include_locale
+          #   Set this to true to receive the locale for this group. Defaults to false.
           # @see https://api.slack.com/methods/groups.info
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.info.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.info.json
           def groups_info(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
@@ -95,14 +82,14 @@ module Slack
           end
 
           #
-          # This method is used to invite a user to a private channel. The calling user must be a member of the private channel.
+          # Invites a user to a private channel.
           #
           # @option options [group] :channel
           #   Private channel to invite user to.
           # @option options [user] :user
           #   User to invite.
           # @see https://api.slack.com/methods/groups.invite
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.invite.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.invite.json
           def groups_invite(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
@@ -112,14 +99,14 @@ module Slack
           end
 
           #
-          # This method allows a user to remove another member from a private channel.
+          # Removes a user from a private channel.
           #
           # @option options [group] :channel
           #   Private channel to remove user from.
           # @option options [user] :user
           #   User to remove from private channel.
           # @see https://api.slack.com/methods/groups.kick
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.kick.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.kick.json
           def groups_kick(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
@@ -129,12 +116,12 @@ module Slack
           end
 
           #
-          # This method is used to leave a private channel.
+          # Leaves a private channel.
           #
           # @option options [group] :channel
           #   Private channel to leave.
           # @see https://api.slack.com/methods/groups.leave
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.leave.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.leave.json
           def groups_leave(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
@@ -142,26 +129,27 @@ module Slack
           end
 
           #
-          # This method returns a list of private channels in the team that the caller is in and archived groups that the caller was in.
-          # The list of (non-deactivated) members in each private channel is also returned.
+          # Lists private channels that the calling user has access to.
           #
           # @option options [Object] :exclude_archived
           #   Don't return archived private channels.
+          # @option options [Object] :exclude_members
+          #   Exclude the members from each group.
           # @see https://api.slack.com/methods/groups.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.list.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.list.json
           def groups_list(options = {})
             post('groups.list', options)
           end
 
           #
-          # This method moves the read cursor in a private channel.
+          # Sets the read cursor in a private channel.
           #
           # @option options [group] :channel
           #   Private channel to set reading cursor in.
           # @option options [timestamp] :ts
           #   Timestamp of the most recently seen message.
           # @see https://api.slack.com/methods/groups.mark
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.mark.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.mark.json
           def groups_mark(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
@@ -170,12 +158,12 @@ module Slack
           end
 
           #
-          # This method opens a private channel.
+          # Opens a private channel.
           #
           # @option options [group] :channel
           #   Private channel to open.
           # @see https://api.slack.com/methods/groups.open
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.open.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.open.json
           def groups_open(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]
@@ -183,7 +171,7 @@ module Slack
           end
 
           #
-          # This method renames a private channel.
+          # Renames a private channel.
           #
           # @option options [group] :channel
           #   Private channel to rename.
@@ -192,7 +180,7 @@ module Slack
           # @option options [Object] :validate
           #   Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.
           # @see https://api.slack.com/methods/groups.rename
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.rename.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.rename.json
           def groups_rename(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
@@ -201,14 +189,14 @@ module Slack
           end
 
           #
-          # This method returns an entire thread (a message plus all the messages in reply to it).
+          # Retrieve a thread of messages posted to a private channel
           #
           # @option options [group] :channel
           #   Private channel to fetch thread from.
           # @option options [Object] :thread_ts
           #   Unique identifier of a thread's parent message.
           # @see https://api.slack.com/methods/groups.replies
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.replies.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.replies.json
           def groups_replies(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :thread_ts missing') if options[:thread_ts].nil?
@@ -217,14 +205,14 @@ module Slack
           end
 
           #
-          # This method is used to change the purpose of a private channel. The calling user must be a member of the private channel.
+          # Sets the purpose for a private channel.
           #
           # @option options [group] :channel
           #   Private channel to set the purpose of.
           # @option options [Object] :purpose
           #   The new purpose.
           # @see https://api.slack.com/methods/groups.setPurpose
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.setPurpose.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.setPurpose.json
           def groups_setPurpose(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :purpose missing') if options[:purpose].nil?
@@ -233,14 +221,14 @@ module Slack
           end
 
           #
-          # This method is used to change the topic of a private channel. The calling user must be a member of the private channel.
+          # Sets the topic for a private channel.
           #
           # @option options [group] :channel
           #   Private channel to set the topic of.
           # @option options [Object] :topic
           #   The new topic.
           # @see https://api.slack.com/methods/groups.setTopic
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.setTopic.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.setTopic.json
           def groups_setTopic(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :topic missing') if options[:topic].nil?
@@ -249,12 +237,12 @@ module Slack
           end
 
           #
-          # This method unarchives a private channel.
+          # Unarchives a private channel.
           #
           # @option options [group] :channel
           #   Private channel to unarchive.
           # @see https://api.slack.com/methods/groups.unarchive
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.unarchive.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/groups/groups.unarchive.json
           def groups_unarchive(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: groups_id(options)['group']['id']) if options[:channel]

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

@@ -6,12 +6,12 @@ module Slack
       module Endpoints
         module Im
           #
-          # This method closes a direct message channel.
+          # Close a direct message channel.
           #
           # @option options [im] :channel
           #   Direct message channel to close.
           # @see https://api.slack.com/methods/im.close
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/im/im.close.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/im/im.close.json
           def im_close(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -19,22 +19,20 @@ module Slack
           end
 
           #
-          # This method returns a portion of messages/events from the specified direct message channel.
-          # To read the entire history for a direct message channel, call the method with no latest or
-          # oldest arguments, and then continue paging using the instructions below.
+          # Fetches history of messages and events from direct message channel.
           #
           # @option options [im] :channel
           #   Direct message channel to fetch history for.
+          # @option options [Object] :inclusive
+          #   Include messages with latest or oldest timestamp in results.
           # @option options [timestamp] :latest
           #   End of time range of messages to include in results.
           # @option options [timestamp] :oldest
           #   Start of time range of messages to include in results.
-          # @option options [Object] :inclusive
-          #   Include messages with latest or oldest timestamp in results.
           # @option options [Object] :unreads
           #   Include unread_count_display in the output?.
           # @see https://api.slack.com/methods/im.history
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/im/im.history.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/im/im.history.json
           def im_history(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -42,23 +40,33 @@ module Slack
           end
 
           #
-          # This method returns a list of all im channels that the user has.
+          # Lists direct message channels for the calling user.
           #
+          # @option options [Object] :cursor
+          #   Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first "page" of the collection. See pagination for more detail.
+          # @option options [Object] :limit
+          #   The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the users list hasn't been reached.
           # @see https://api.slack.com/methods/im.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/im/im.list.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/im/im.list.json
           def im_list(options = {})
-            post('im.list', options)
+            if block_given?
+              Pagination::Cursor.new(self, :im_list, options).each do |page|
+                yield page
+              end
+            else
+              post('im.list', options)
+            end
           end
 
           #
-          # This method moves the read cursor in a direct message channel.
+          # Sets the read cursor in a direct message channel.
           #
           # @option options [im] :channel
           #   Direct message channel to set reading cursor in.
           # @option options [timestamp] :ts
           #   Timestamp of the most recently seen message.
           # @see https://api.slack.com/methods/im.mark
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/im/im.mark.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/im/im.mark.json
           def im_mark(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
@@ -67,14 +75,16 @@ module Slack
           end
 
           #
-          # This method opens a direct message channel with another member of your Slack team.
+          # Opens a direct message channel.
           #
           # @option options [user] :user
           #   User to open a direct message channel with.
+          # @option options [Object] :include_locale
+          #   Set this to true to receive the locale for this im. Defaults to false.
           # @option options [Object] :return_im
           #   Boolean, indicates you want the full IM channel definition in the response.
           # @see https://api.slack.com/methods/im.open
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/im/im.open.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/im/im.open.json
           def im_open(options = {})
             throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
@@ -82,14 +92,14 @@ module Slack
           end
 
           #
-          # This method returns an entire thread (a message plus all the messages in reply to it).
+          # Retrieve a thread of messages posted to a direct message conversation
           #
           # @option options [im] :channel
           #   Direct message channel to fetch thread from.
           # @option options [Object] :thread_ts
           #   Unique identifier of a thread's parent message.
           # @see https://api.slack.com/methods/im.replies
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/im/im.replies.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/im/im.replies.json
           def im_replies(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :thread_ts missing') if options[:thread_ts].nil?

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

@@ -0,0 +1,25 @@
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module Migration
+          #
+          # For Enterprise Grid workspaces, map local user IDs to global user IDs
+          #
+          # @option options [Object] :users
+          #   A comma-separated list of user ids, up to 400 per request.
+          # @option options [Object] :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?
+            post('migration.exchange', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -6,12 +6,12 @@ module Slack
       module Endpoints
         module Mpim
           #
-          # This method closes a multiparty direct message channel.
+          # Closes a multiparty direct message channel.
           #
           # @option options [channel] :channel
           #   MPIM to close.
           # @see https://api.slack.com/methods/mpim.close
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/mpim/mpim.close.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/mpim/mpim.close.json
           def mpim_close(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -19,22 +19,20 @@ module Slack
           end
 
           #
-          # This method returns a portion of messages/events from the specified multiparty direct message channel.
-          # To read the entire history for a multiparty direct message, call the method with no latest or
-          # oldest arguments, and then continue paging using the instructions below.
+          # Fetches history of messages and events from a multiparty direct message.
           #
           # @option options [channel] :channel
           #   Multiparty direct message to fetch history for.
+          # @option options [Object] :inclusive
+          #   Include messages with latest or oldest timestamp in results.
           # @option options [timestamp] :latest
           #   End of time range of messages to include in results.
           # @option options [timestamp] :oldest
           #   Start of time range of messages to include in results.
-          # @option options [Object] :inclusive
-          #   Include messages with latest or oldest timestamp in results.
           # @option options [Object] :unreads
           #   Include unread_count_display in the output?.
           # @see https://api.slack.com/methods/mpim.history
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/mpim/mpim.history.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/mpim/mpim.history.json
           def mpim_history(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -42,23 +40,23 @@ module Slack
           end
 
           #
-          # This method returns a list of all multiparty direct message channels that the user has.
+          # Lists multiparty direct message channels for the calling user.
           #
           # @see https://api.slack.com/methods/mpim.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/mpim/mpim.list.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/mpim/mpim.list.json
           def mpim_list(options = {})
             post('mpim.list', options)
           end
 
           #
-          # This method moves the read cursor in a multiparty direct message channel.
+          # Sets the read cursor in a multiparty direct message channel.
           #
           # @option options [channel] :channel
           #   multiparty direct message channel to set reading cursor in.
           # @option options [timestamp] :ts
           #   Timestamp of the most recently seen message.
           # @see https://api.slack.com/methods/mpim.mark
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/mpim/mpim.mark.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/mpim/mpim.mark.json
           def mpim_mark(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
@@ -72,21 +70,21 @@ module Slack
           # @option options [Object] :users
           #   Comma separated lists of users.  The ordering of the users is preserved whenever a MPIM group is returned.
           # @see https://api.slack.com/methods/mpim.open
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/mpim/mpim.open.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/mpim/mpim.open.json
           def mpim_open(options = {})
             throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?
             post('mpim.open', options)
           end
 
           #
-          # This method returns an entire thread (a message plus all the messages in reply to it).
+          # Retrieve a thread of messages posted to a direct message conversation from a multiparty direct message.
           #
           # @option options [channel] :channel
           #   Multiparty direct message channel to fetch thread from.
           # @option options [Object] :thread_ts
           #   Unique identifier of a thread's parent message.
           # @see https://api.slack.com/methods/mpim.replies
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/mpim/mpim.replies.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/mpim/mpim.replies.json
           def mpim_replies(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :thread_ts missing') if options[:thread_ts].nil?

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

@@ -6,8 +6,7 @@ module Slack
       module Endpoints
         module Oauth
           #
-          # This method allows you to exchange a temporary OAuth code for an API access token.
-          # This is used as part of the OAuth authentication flow.
+          # Exchanges a temporary OAuth code for an API token.
           #
           # @option options [Object] :client_id
           #   Issued when you created your application.
@@ -18,13 +17,35 @@ module Slack
           # @option options [Object] :redirect_uri
           #   This must match the originally submitted URI (if one was sent).
           # @see https://api.slack.com/methods/oauth.access
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/oauth/oauth.access.json
+          # @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/pins.rb

@@ -6,8 +6,7 @@ module Slack
       module Endpoints
         module Pins
           #
-          # This method pins an item (file, file comment, channel message, or group message) to a particular channel.
-          # The channel argument is required and one of file, file_comment, or timestamp must also be specified.
+          # Pins an item to a channel.
           #
           # @option options [channel] :channel
           #   Channel to pin the item in.
@@ -18,7 +17,7 @@ module Slack
           # @option options [Object] :timestamp
           #   Timestamp of the message to pin.
           # @see https://api.slack.com/methods/pins.add
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/pins/pins.add.json
+          # @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]
@@ -26,12 +25,12 @@ module Slack
           end
 
           #
-          # This method lists the items pinned to a channel.
+          # Lists items pinned to a channel.
           #
           # @option options [channel] :channel
           #   Channel to get pinned items for.
           # @see https://api.slack.com/methods/pins.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/pins/pins.list.json
+          # @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]
@@ -39,8 +38,7 @@ module Slack
           end
 
           #
-          # This method un-pins an item (file, file comment, channel message, or group message) from a channel.
-          # The channel argument is required and one of file, file_comment, or timestamp must also be specified.
+          # Un-pins an item from a channel.
           #
           # @option options [channel] :channel
           #   Channel where the item is pinned to.
@@ -51,7 +49,7 @@ module Slack
           # @option options [Object] :timestamp
           #   Timestamp of the message to un-pin.
           # @see https://api.slack.com/methods/pins.remove
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/pins/pins.remove.json
+          # @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]

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

@@ -11,7 +11,7 @@ module Slack
           # @option options [Object] :presence
           #   Either `active` or `away`.
           # @see https://api.slack.com/methods/presence.set
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/presence.set.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/presence.set.json
           def presence_set(options = {})
             throw ArgumentError.new('Required arguments :presence missing') if options[:presence].nil?
             post('presence.set', options)