slack-ruby-client 0.6.0 → 0.7.0

data/lib/slack/version.rb

@@ -1,3 +1,3 @@
 module Slack
-  VERSION = '0.6.0'
+  VERSION = '0.7.0'
 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.test.json
+          # @see https://github.com/dblock/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/auth.rb

@@ -9,7 +9,7 @@ module Slack
           # This method checks authentication and tells you who you are.
           #
           # @see https://api.slack.com/methods/auth.test
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/auth.test.json
+          # @see https://github.com/dblock/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/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.archive.json
+          # @see https://github.com/dblock/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]
@@ -24,7 +24,7 @@ module Slack
           # @option options [Object] :name
           #   Name of channel to create.
           # @see https://api.slack.com/methods/channels.create
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels.create.json
+          # @see https://github.com/dblock/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)
@@ -44,7 +44,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.history.json
+          # @see https://github.com/dblock/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]
@@ -57,7 +57,7 @@ module Slack
           # @option options [channel] :channel
           #   Channel to get info on.
           # @see https://api.slack.com/methods/channels.info
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels.info.json
+          # @see https://github.com/dblock/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]
@@ -72,7 +72,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.invite.json
+          # @see https://github.com/dblock/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?
@@ -88,7 +88,7 @@ module Slack
           # @option options [Object] :name
           #   Name of channel to join.
           # @see https://api.slack.com/methods/channels.join
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels.join.json
+          # @see https://github.com/dblock/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)
@@ -102,7 +102,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.kick.json
+          # @see https://github.com/dblock/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?
@@ -117,7 +117,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.leave.json
+          # @see https://github.com/dblock/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]
@@ -130,7 +130,7 @@ module Slack
           # @option options [Object] :exclude_archived
           #   Don't return archived channels.
           # @see https://api.slack.com/methods/channels.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels.list.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.list.json
           def channels_list(options = {})
             post('channels.list', options)
           end
@@ -143,7 +143,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.mark.json
+          # @see https://github.com/dblock/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?
@@ -159,7 +159,7 @@ module Slack
           # @option options [Object] :name
           #   New name for channel.
           # @see https://api.slack.com/methods/channels.rename
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels.rename.json
+          # @see https://github.com/dblock/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?
@@ -175,7 +175,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.setPurpose.json
+          # @see https://github.com/dblock/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?
@@ -191,7 +191,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.setTopic.json
+          # @see https://github.com/dblock/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?
@@ -205,7 +205,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.unarchive.json
+          # @see https://github.com/dblock/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

@@ -13,7 +13,7 @@ module Slack
           # @option options [channel] :channel
           #   Channel containing the message to be deleted.
           # @see https://api.slack.com/methods/chat.delete
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat.delete.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat/chat.delete.json
           def chat_delete(options = {})
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
@@ -28,12 +28,8 @@ module Slack
           #   Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name. See below for more details.
           # @option options [Object] :text
           #   Text of the message to send. See below for an explanation of formatting.
-          # @option options [Object] :username
-          #   Name of bot.
-          # @option options [Object] :as_user
-          #   Pass true to post the message as the authed user, instead of as a bot.
           # @option options [Object] :parse
-          #   Change how messages are treated. See below.
+          #   Change how messages are treated. Defaults to none. See below.
           # @option options [Object] :link_names
           #   Find and link channel names and usernames.
           # @option options [Object] :attachments
@@ -42,12 +38,16 @@ module Slack
           #   Pass true to enable unfurling of primarily text-based content.
           # @option options [Object] :unfurl_media
           #   Pass false to disable unfurling of media content.
+          # @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.
+          # @option options [Object] :as_user
+          #   Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below.
           # @option options [Object] :icon_url
-          #   URL to an image to use as the icon for this message.
+          #   URL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
           # @option options [Object] :icon_emoji
-          #   emoji to use as the icon for this message. Overrides icon_url.
+          #   emoji to use as the icon for this message. Overrides icon_url. 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.postMessage.json
+          # @see https://github.com/dblock/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?
@@ -61,7 +61,7 @@ module Slack
           end
 
           #
-          # This method updates a message in a channel.
+          # This method updates a message in a channel. Though related to chat.postMessage, some parameters of chat.update are handled differently.
           #
           # @option options [timestamp] :ts
           #   Timestamp of the message to be updated.
@@ -72,11 +72,13 @@ module Slack
           # @option options [Object] :attachments
           #   Structured message attachments.
           # @option options [Object] :parse
-          #   Change how messages are treated. See below.
+          #   Change how messages are treated. Defaults to client, unlike chat.postMessage. See below.
           # @option options [Object] :link_names
-          #   Find and link channel names and usernames.
+          #   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] :as_user
+          #   Pass true to update the message as the authed user. Bot users in this context are considered authed users.
           # @see https://api.slack.com/methods/chat.update
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat.update.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/chat/chat.update.json
           def chat_update(options = {})
             throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?

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

@@ -9,7 +9,7 @@ module Slack
           # Ends the user's currently scheduled Do Not Disturb session immediately.
           #
           # @see https://api.slack.com/methods/dnd.endDnd
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd.endDnd.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd/dnd.endDnd.json
           def dnd_endDnd(options = {})
             post('dnd.endDnd', options)
           end
@@ -18,7 +18,7 @@ module Slack
           # Ends the current user's snooze mode immediately.
           #
           # @see https://api.slack.com/methods/dnd.endSnooze
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd.endSnooze.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd/dnd.endSnooze.json
           def dnd_endSnooze(options = {})
             post('dnd.endSnooze', options)
           end
@@ -29,7 +29,7 @@ module Slack
           # @option options [user] :user
           #   User to fetch status for (defaults to current user).
           # @see https://api.slack.com/methods/dnd.info
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd.info.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd/dnd.info.json
           def dnd_info(options = {})
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             post('dnd.info', options)
@@ -41,7 +41,7 @@ module Slack
           # @option options [Object] :num_minutes
           #   Number of minutes, from now, to snooze until.
           # @see https://api.slack.com/methods/dnd.setSnooze
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd.setSnooze.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd/dnd.setSnooze.json
           def dnd_setSnooze(options = {})
             throw ArgumentError.new('Required arguments :num_minutes missing') if options[:num_minutes].nil?
             post('dnd.setSnooze', options)
@@ -53,7 +53,7 @@ module Slack
           # @option options [Object] :users
           #   Comma-separated list of users to fetch Do Not Disturb status for.
           # @see https://api.slack.com/methods/dnd.teamInfo
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd.teamInfo.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/dnd/dnd.teamInfo.json
           def dnd_teamInfo(options = {})
             post('dnd.teamInfo', options)
           end

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

@@ -9,7 +9,7 @@ module Slack
           # This method lists the custom emoji for a team.
           #
           # @see https://api.slack.com/methods/emoji.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/emoji.list.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/emoji/emoji.list.json
           def emoji_list(options = {})
             post('emoji.list', options)
           end

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

@@ -15,7 +15,7 @@ module Slack
           # @option options [Object] :comment
           #   Text of the comment to edit.
           # @see https://api.slack.com/methods/files.comments
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files.comments.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.comments.json
           def files_comments(options = {})
             throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
             throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
@@ -29,7 +29,7 @@ module Slack
           # @option options [file] :file
           #   ID of file to delete.
           # @see https://api.slack.com/methods/files.delete
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files.delete.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.delete.json
           def files_delete(options = {})
             throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
             post('files.delete', options)
@@ -39,9 +39,9 @@ module Slack
           # This method returns information about a file in your team.
           #
           # @option options [file] :file
-          #   File to fetch info for.
+          #   Specify a file by providing its ID.
           # @see https://api.slack.com/methods/files.info
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files.info.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.info.json
           def files_info(options = {})
             throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
             post('files.info', options)
@@ -73,13 +73,37 @@ module Slack
           #   You can pass multiple values in the types argument, like types=posts,snippets.The default value is all, which does not filter the list.
           #   .
           # @see https://api.slack.com/methods/files.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files.list.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.list.json
           def files_list(options = {})
             options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             post('files.list', options)
           end
 
+          #
+          # This method disables public/external sharing for a file.
+          #
+          # @option options [file] :file
+          #   File to revoke.
+          # @see https://api.slack.com/methods/files.revokePublicURL
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.revokePublicURL.json
+          def files_revokePublicURL(options = {})
+            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
+            post('files.revokePublicURL', options)
+          end
+
+          #
+          # This method enables public/external sharing for a file.
+          #
+          # @option options [file] :file
+          #   File to share.
+          # @see https://api.slack.com/methods/files.sharedPublicURL
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.sharedPublicURL.json
+          def files_sharedPublicURL(options = {})
+            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
+            post('files.sharedPublicURL', options)
+          end
+
           #
           # This method allows you to create or upload an existing file.
           #
@@ -98,7 +122,7 @@ module Slack
           # @option options [Object] :channels
           #   Comma-separated list of channel names or IDs where the file will be shared.
           # @see https://api.slack.com/methods/files.upload
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files.upload.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.upload.json
           def files_upload(options = {})
             throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
             throw ArgumentError.new('Required arguments :filename missing') if options[:filename].nil?

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

@@ -11,7 +11,7 @@ module Slack
           # @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.archive.json
+          # @see https://github.com/dblock/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]
@@ -24,7 +24,7 @@ module Slack
           # @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.close.json
+          # @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]
@@ -37,7 +37,7 @@ module Slack
           # @option options [Object] :name
           #   Name of private channel to create.
           # @see https://api.slack.com/methods/groups.create
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.create.json
+          # @see https://github.com/dblock/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)
@@ -49,7 +49,7 @@ module Slack
           # @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.createChild.json
+          # @see https://github.com/dblock/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]
@@ -72,7 +72,7 @@ module Slack
           # @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.history.json
+          # @see https://github.com/dblock/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]
@@ -85,7 +85,7 @@ module Slack
           # @option options [group] :channel
           #   Private channel to get info on.
           # @see https://api.slack.com/methods/groups.info
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.info.json
+          # @see https://github.com/dblock/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]
@@ -100,7 +100,7 @@ module Slack
           # @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.invite.json
+          # @see https://github.com/dblock/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?
@@ -117,7 +117,7 @@ module Slack
           # @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.kick.json
+          # @see https://github.com/dblock/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?
@@ -132,7 +132,7 @@ module Slack
           # @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.leave.json
+          # @see https://github.com/dblock/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]
@@ -146,7 +146,7 @@ module Slack
           # @option options [Object] :exclude_archived
           #   Don't return archived private channels.
           # @see https://api.slack.com/methods/groups.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.list.json
+          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups/groups.list.json
           def groups_list(options = {})
             post('groups.list', options)
           end
@@ -159,7 +159,7 @@ module Slack
           # @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.mark.json
+          # @see https://github.com/dblock/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?
@@ -173,7 +173,7 @@ module Slack
           # @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.open.json
+          # @see https://github.com/dblock/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]
@@ -188,7 +188,7 @@ module Slack
           # @option options [Object] :name
           #   New name for private channel.
           # @see https://api.slack.com/methods/groups.rename
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/groups.rename.json
+          # @see https://github.com/dblock/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?
@@ -204,7 +204,7 @@ module Slack
           # @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.setPurpose.json
+          # @see https://github.com/dblock/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?
@@ -220,7 +220,7 @@ module Slack
           # @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.setTopic.json
+          # @see https://github.com/dblock/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?
@@ -234,7 +234,7 @@ module Slack
           # @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.unarchive.json
+          # @see https://github.com/dblock/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]