slack-ruby-client 0.10.0 → 0.11.0

data/lib/slack/version.rb

@@ -1,3 +1,3 @@
 module Slack
-  VERSION = '0.10.0'.freeze
+  VERSION = '0.11.0'.freeze
 end

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

@@ -13,7 +13,7 @@ module Slack
           # @option options [Object] :foo
           #   example property to return.
           # @see https://api.slack.com/methods/api.test
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/api/api.test.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/api/api.test.json
           def api_test(options = {})
             post('api.test', options)
           end

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

@@ -9,7 +9,7 @@ module Slack
           # Returns list of permissions this app has on a team.
           #
           # @see https://api.slack.com/methods/apps.permissions.info
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/apps.permissions/apps.permissions.info.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.permissions/apps.permissions.info.json
           def apps_permissions_info(options = {})
             post('apps.permissions.info', options)
           end
@@ -22,7 +22,7 @@ module Slack
           # @option options [Object] :trigger_id
           #   Token used to trigger the permissions API.
           # @see https://api.slack.com/methods/apps.permissions.request
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/apps.permissions/apps.permissions.request.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.permissions/apps.permissions.request.json
           def apps_permissions_request(options = {})
             throw ArgumentError.new('Required arguments :scopes missing') if options[:scopes].nil?
             throw ArgumentError.new('Required arguments :trigger_id missing') if options[:trigger_id].nil?

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

@@ -11,7 +11,7 @@ module Slack
           # @option options [Object] :test
           #   Setting this parameter to 1 triggers a testing mode where the specified token will not actually be revoked.
           # @see https://api.slack.com/methods/auth.revoke
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/auth/auth.revoke.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/auth/auth.revoke.json
           def auth_revoke(options = {})
             post('auth.revoke', options)
           end
@@ -20,7 +20,7 @@ module Slack
           # Checks authentication & identity.
           #
           # @see https://api.slack.com/methods/auth.test
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/auth/auth.test.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/auth/auth.test.json
           def auth_test(options = {})
             post('auth.test', options)
           end

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

@@ -11,7 +11,7 @@ module Slack
           # @option options [Object] :bot
           #   Bot user to get info on.
           # @see https://api.slack.com/methods/bots.info
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/bots/bots.info.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/bots/bots.info.json
           def bots_info(options = {})
             post('bots.info', options)
           end

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

@@ -11,7 +11,7 @@ module Slack
           # @option options [channel] :channel
           #   Channel to archive.
           # @see https://api.slack.com/methods/channels.archive
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.archive.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.archive.json
           def channels_archive(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 +26,24 @@ 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/channels.create
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.create.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.create.json
           def channels_create(options = {})
             throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
             post('channels.create', options)
           end
 
+          #
+          # Delete a channel (undocumented)
+          #
+          # @option options [channel] :channel
+          #   Channel to delete.
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/undocumented/channels/channels.delete.json
+          def channels_delete(options = {})
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('channels.delete', options)
+          end
+
           #
           # Fetches history of messages and events from a channel.
           #
@@ -46,7 +58,7 @@ module Slack
           # @option options [Object] :unreads
           #   Include unread_count_display in the output?.
           # @see https://api.slack.com/methods/channels.history
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.history.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.history.json
           def channels_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]
@@ -61,7 +73,7 @@ module Slack
           # @option options [Object] :include_locale
           #   Set this to true to receive the locale for this channel. Defaults to false.
           # @see https://api.slack.com/methods/channels.info
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.info.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.info.json
           def channels_info(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -76,7 +88,7 @@ module Slack
           # @option options [user] :user
           #   User to invite to channel.
           # @see https://api.slack.com/methods/channels.invite
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.invite.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.invite.json
           def channels_invite(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
@@ -93,7 +105,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/channels.join
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.join.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.join.json
           def channels_join(options = {})
             throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
             post('channels.join', options)
@@ -107,7 +119,7 @@ module Slack
           # @option options [user] :user
           #   User to remove from channel.
           # @see https://api.slack.com/methods/channels.kick
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.kick.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.kick.json
           def channels_kick(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
@@ -122,7 +134,7 @@ module Slack
           # @option options [channel] :channel
           #   Channel to leave.
           # @see https://api.slack.com/methods/channels.leave
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.leave.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.leave.json
           def channels_leave(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -141,7 +153,7 @@ module Slack
           # @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/channels.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.list.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.list.json
           def channels_list(options = {})
             if block_given?
               Pagination::Cursor.new(self, :channels_list, options).each do |page|
@@ -160,7 +172,7 @@ module Slack
           # @option options [timestamp] :ts
           #   Timestamp of the most recently seen message.
           # @see https://api.slack.com/methods/channels.mark
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.mark.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.mark.json
           def channels_mark(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
@@ -178,7 +190,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/channels.rename
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.rename.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.rename.json
           def channels_rename(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
@@ -194,7 +206,7 @@ module Slack
           # @option options [Object] :thread_ts
           #   Unique identifier of a thread's parent message.
           # @see https://api.slack.com/methods/channels.replies
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.replies.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.replies.json
           def channels_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?
@@ -210,7 +222,7 @@ module Slack
           # @option options [Object] :purpose
           #   The new purpose.
           # @see https://api.slack.com/methods/channels.setPurpose
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.setPurpose.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.setPurpose.json
           def channels_setPurpose(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :purpose missing') if options[:purpose].nil?
@@ -226,7 +238,7 @@ module Slack
           # @option options [Object] :topic
           #   The new topic.
           # @see https://api.slack.com/methods/channels.setTopic
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.setTopic.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.setTopic.json
           def channels_setTopic(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :topic missing') if options[:topic].nil?
@@ -240,7 +252,7 @@ module Slack
           # @option options [channel] :channel
           #   Channel to unarchive.
           # @see https://api.slack.com/methods/channels.unarchive
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.unarchive.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/channels/channels.unarchive.json
           def channels_unarchive(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/chat.rb

@@ -5,6 +5,23 @@ module Slack
     module Api
       module Endpoints
         module Chat
+          #
+          # Execute a slash command in a public channel (undocumented)
+          #
+          # @option options [channel] :channel
+          #   Channel to execute the command in.
+          # @option options [Object] :command
+          #   Slash command to be executed. Leading backslash is required.
+          # @option options [Object] :text
+          #   Additional parameters provided to the slash command.
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/undocumented/chat/chat.command.json
+          def chat_command(options = {})
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            throw ArgumentError.new('Required arguments :command missing') if options[:command].nil?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('chat.command', options)
+          end
+
           #
           # Deletes a message.
           #
@@ -13,9 +30,9 @@ module Slack
           # @option options [timestamp] :ts
           #   Timestamp of the message to be deleted.
           # @option options [Object] :as_user
-          #   Pass true to delete the message as the authed user. Bot users in this context are considered authed users.
+          #   Pass true to delete the message as the authed user with chat:write:user scope. Bot users in this context are considered authed users. If unused or false, the message will be deleted with chat:write:bot scope.
           # @see https://api.slack.com/methods/chat.delete
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat/chat.delete.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.delete.json
           def chat_delete(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
@@ -23,6 +40,22 @@ module Slack
             post('chat.delete', options)
           end
 
+          #
+          # Retrieve a permalink URL for a specific extant message
+          #
+          # @option options [channel] :channel
+          #   The ID of the conversation or channel containing the message.
+          # @option options [Object] :message_ts
+          #   A message's ts value, uniquely identifying it within a channel.
+          # @see https://api.slack.com/methods/chat.getPermalink
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.getPermalink.json
+          def chat_getPermalink(options = {})
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            throw ArgumentError.new('Required arguments :message_ts missing') if options[:message_ts].nil?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('chat.getPermalink', options)
+          end
+
           #
           # Share a me message into a channel.
           #
@@ -31,7 +64,7 @@ module Slack
           # @option options [Object] :text
           #   Text of the message to send.
           # @see https://api.slack.com/methods/chat.meMessage
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat/chat.meMessage.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.meMessage.json
           def chat_meMessage(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :text missing') if options[:text].nil?
@@ -56,7 +89,7 @@ module Slack
           # @option options [Object] :parse
           #   Change how messages are treated. Defaults to none. See below.
           # @see https://api.slack.com/methods/chat.postEphemeral
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat/chat.postEphemeral.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postEphemeral.json
           def chat_postEphemeral(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :text missing') if options[:text].nil?
@@ -101,7 +134,7 @@ module Slack
           # @option options [Object] :username
           #   Set your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
           # @see https://api.slack.com/methods/chat.postMessage
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat/chat.postMessage.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postMessage.json
           def chat_postMessage(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :text or :attachments missing') if options[:text].nil? && options[:attachments].nil?
@@ -130,7 +163,7 @@ module Slack
           # @option options [Object] :user_auth_url
           #   Send users to this custom URL where they will complete authentication in your app to fully trigger unfurling. Value should be properly URL-encoded.
           # @see https://api.slack.com/methods/chat.unfurl
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat/chat.unfurl.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.unfurl.json
           def chat_unfurl(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
@@ -145,19 +178,19 @@ module Slack
           # @option options [channel] :channel
           #   Channel containing the message to be updated.
           # @option options [Object] :text
-          #   New text for the message, using the default formatting rules.
+          #   New text for the message, using the default formatting rules. It's not required when presenting attachments.
           # @option options [timestamp] :ts
           #   Timestamp of the message to be updated.
           # @option options [Object] :as_user
           #   Pass true to update the message as the authed user. Bot users in this context are considered authed users.
           # @option options [Object] :attachments
-          #   A JSON-based array of structured attachments, presented as a URL-encoded string.
+          #   A JSON-based array of structured attachments, presented as a URL-encoded string. This field is required when not presenting text.
           # @option options [Object] :link_names
           #   Find and link channel names and usernames. Defaults to none. This parameter should be used in conjunction with parse. To set link_names to 1, specify a parse mode of full.
           # @option options [Object] :parse
           #   Change how messages are treated. Defaults to client, unlike chat.postMessage. See below.
           # @see https://api.slack.com/methods/chat.update
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat/chat.update.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.update.json
           def chat_update(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :text or :attachments missing') if options[:text].nil? && options[:attachments].nil?

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

@@ -11,7 +11,7 @@ module Slack
           # @option options [channel] :channel
           #   ID of conversation to archive.
           # @see https://api.slack.com/methods/conversations.archive
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.archive.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.archive.json
           def conversations_archive(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -24,7 +24,7 @@ module Slack
           # @option options [channel] :channel
           #   Conversation to close.
           # @see https://api.slack.com/methods/conversations.close
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.close.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.close.json
           def conversations_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]
@@ -39,7 +39,7 @@ module Slack
           # @option options [Object] :is_private
           #   Create a private channel instead of a public one.
           # @see https://api.slack.com/methods/conversations.create
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.create.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.create.json
           def conversations_create(options = {})
             throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
             post('conversations.create', options)
@@ -59,7 +59,7 @@ module Slack
           # @option options [timestamp] :oldest
           #   Start of time range of messages to include in results.
           # @see https://api.slack.com/methods/conversations.history
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.history.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.history.json
           def conversations_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]
@@ -80,7 +80,7 @@ module Slack
           # @option options [Object] :include_locale
           #   Set this to true to receive the locale for this conversation. Defaults to false.
           # @see https://api.slack.com/methods/conversations.info
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.info.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.info.json
           def conversations_info(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -95,7 +95,7 @@ module Slack
           # @option options [Object] :users
           #   A comma separated list of user IDs. Up to 30 users may be listed.
           # @see https://api.slack.com/methods/conversations.invite
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.invite.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.invite.json
           def conversations_invite(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?
@@ -109,7 +109,7 @@ module Slack
           # @option options [channel] :channel
           #   ID of conversation to join.
           # @see https://api.slack.com/methods/conversations.join
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.join.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.join.json
           def conversations_join(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -124,7 +124,7 @@ module Slack
           # @option options [user] :user
           #   User ID to be removed.
           # @see https://api.slack.com/methods/conversations.kick
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.kick.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.kick.json
           def conversations_kick(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
@@ -139,7 +139,7 @@ module Slack
           # @option options [channel] :channel
           #   Conversation to leave.
           # @see https://api.slack.com/methods/conversations.leave
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.leave.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.leave.json
           def conversations_leave(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -158,7 +158,7 @@ module Slack
           # @option options [Object] :types
           #   Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im.
           # @see https://api.slack.com/methods/conversations.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.list.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.list.json
           def conversations_list(options = {})
             if block_given?
               Pagination::Cursor.new(self, :conversations_list, options).each do |page|
@@ -179,7 +179,7 @@ module Slack
           # @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/conversations.members
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.members.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.members.json
           def conversations_members(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
@@ -202,7 +202,7 @@ module Slack
           # @option options [Object] :users
           #   Comma separated lists of users. If only one user is included, this creates a 1:1 DM.  The ordering of the users is preserved whenever a multi-person direct message is returned. Supply a channel when not supplying users.
           # @see https://api.slack.com/methods/conversations.open
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.open.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.open.json
           def conversations_open(options = {})
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
             post('conversations.open', options)
@@ -216,7 +216,7 @@ module Slack
           # @option options [Object] :name
           #   New name for conversation.
           # @see https://api.slack.com/methods/conversations.rename
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.rename.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.rename.json
           def conversations_rename(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
@@ -236,7 +236,7 @@ module Slack
           # @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/conversations.replies
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.replies.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.replies.json
           def conversations_replies(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
@@ -258,7 +258,7 @@ module Slack
           # @option options [Object] :purpose
           #   A new, specialer purpose.
           # @see https://api.slack.com/methods/conversations.setPurpose
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.setPurpose.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.setPurpose.json
           def conversations_setPurpose(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :purpose missing') if options[:purpose].nil?
@@ -274,7 +274,7 @@ module Slack
           # @option options [Object] :topic
           #   The new topic string. Does not support formatting or linkification.
           # @see https://api.slack.com/methods/conversations.setTopic
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.setTopic.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.setTopic.json
           def conversations_setTopic(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             throw ArgumentError.new('Required arguments :topic missing') if options[:topic].nil?
@@ -288,7 +288,7 @@ module Slack
           # @option options [channel] :channel
           #   ID of conversation to unarchive.
           # @see https://api.slack.com/methods/conversations.unarchive
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/conversations/conversations.unarchive.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.unarchive.json
           def conversations_unarchive(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]