slack-ruby-client 0.9.0 → 0.11.0

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

@@ -0,0 +1,301 @@
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module Conversations
+          #
+          # Archives a conversation.
+          #
+          # @option options [channel] :channel
+          #   ID of conversation to archive.
+          # @see https://api.slack.com/methods/conversations.archive
+          # @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]
+            post('conversations.archive', options)
+          end
+
+          #
+          # Closes a direct message or multi-person direct message.
+          #
+          # @option options [channel] :channel
+          #   Conversation to close.
+          # @see https://api.slack.com/methods/conversations.close
+          # @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]
+            post('conversations.close', options)
+          end
+
+          #
+          # Initiates a public or private channel-based conversation
+          #
+          # @option options [Object] :name
+          #   Name of the public or private channel to create.
+          # @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/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)
+          end
+
+          #
+          # Fetches a conversation's history of messages and events.
+          #
+          # @option options [channel] :channel
+          #   Conversation ID to fetch history for.
+          # @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 [timestamp] :latest
+          #   End of time range of messages to include in results.
+          # @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.
+          # @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/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]
+            if block_given?
+              Pagination::Cursor.new(self, :conversations_history, options).each do |page|
+                yield page
+              end
+            else
+              post('conversations.history', options)
+            end
+          end
+
+          #
+          # Retrieve information about a conversation.
+          #
+          # @option options [channel] :channel
+          #   Conversation ID to learn more about.
+          # @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/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]
+            post('conversations.info', options)
+          end
+
+          #
+          # Invites users to a channel.
+          #
+          # @option options [channel] :channel
+          #   The ID of the public or private channel to invite user(s) to.
+          # @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/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?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('conversations.invite', options)
+          end
+
+          #
+          # Joins an existing conversation.
+          #
+          # @option options [channel] :channel
+          #   ID of conversation to join.
+          # @see https://api.slack.com/methods/conversations.join
+          # @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]
+            post('conversations.join', options)
+          end
+
+          #
+          # Removes a user from a conversation.
+          #
+          # @option options [channel] :channel
+          #   ID of conversation to remove user from.
+          # @option options [user] :user
+          #   User ID to be removed.
+          # @see https://api.slack.com/methods/conversations.kick
+          # @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?
+            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('conversations.kick', options)
+          end
+
+          #
+          # Leaves a conversation.
+          #
+          # @option options [channel] :channel
+          #   Conversation to leave.
+          # @see https://api.slack.com/methods/conversations.leave
+          # @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]
+            post('conversations.leave', options)
+          end
+
+          #
+          # Lists all channels in a Slack team.
+          #
+          # @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] :exclude_archived
+          #   Set to true to exclude archived channels from the list.
+          # @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 list hasn't been reached. Must be an integer no larger than 1000.
+          # @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/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|
+                yield page
+              end
+            else
+              post('conversations.list', options)
+            end
+          end
+
+          #
+          # Retrieve members of a conversation.
+          #
+          # @option options [channel] :channel
+          #   ID of the conversation to retrieve members for.
+          # @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/conversations.members
+          # @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]
+            if block_given?
+              Pagination::Cursor.new(self, :conversations_members, options).each do |page|
+                yield page
+              end
+            else
+              post('conversations.members', options)
+            end
+          end
+
+          #
+          # Opens or resumes a direct message or multi-person direct message.
+          #
+          # @option options [channel] :channel
+          #   Resume a conversation by supplying an im or mpim's ID. Or provide the users field instead.
+          # @option options [Object] :return_im
+          #   Boolean, indicates you want the full IM channel definition in the response.
+          # @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/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)
+          end
+
+          #
+          # Renames a conversation.
+          #
+          # @option options [channel] :channel
+          #   ID of conversation to rename.
+          # @option options [Object] :name
+          #   New name for conversation.
+          # @see https://api.slack.com/methods/conversations.rename
+          # @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?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('conversations.rename', options)
+          end
+
+          #
+          # Retrieve a thread of messages posted to a conversation
+          #
+          # @option options [channel] :channel
+          #   Conversation ID to fetch thread from.
+          # @option options [timestamp] :ts
+          #   Unique identifier of a thread's parent message.
+          # @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/conversations.replies
+          # @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?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            if block_given?
+              Pagination::Cursor.new(self, :conversations_replies, options).each do |page|
+                yield page
+              end
+            else
+              post('conversations.replies', options)
+            end
+          end
+
+          #
+          # Sets the purpose for a conversation.
+          #
+          # @option options [channel] :channel
+          #   Conversation to set the purpose of.
+          # @option options [Object] :purpose
+          #   A new, specialer purpose.
+          # @see https://api.slack.com/methods/conversations.setPurpose
+          # @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?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('conversations.setPurpose', options)
+          end
+
+          #
+          # Sets the topic for a conversation.
+          #
+          # @option options [channel] :channel
+          #   Conversation to set the topic of.
+          # @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/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?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('conversations.setTopic', options)
+          end
+
+          #
+          # Reverses conversation archival.
+          #
+          # @option options [channel] :channel
+          #   ID of conversation to unarchive.
+          # @see https://api.slack.com/methods/conversations.unarchive
+          # @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]
+            post('conversations.unarchive', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module Dialog
+          #
+          # Open a dialog with a user
+          #
+          # @option options [Object] :dialog
+          #   The dialog definition. This must be a JSON-encoded string.
+          # @option options [Object] :trigger_id
+          #   Exchange a trigger to post to the user.
+          # @see https://api.slack.com/methods/dialog.open
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/dialog/dialog.open.json
+          def dialog_open(options = {})
+            throw ArgumentError.new('Required arguments :dialog missing') if options[:dialog].nil?
+            throw ArgumentError.new('Required arguments :trigger_id missing') if options[:trigger_id].nil?
+            # dialog must be passed as an encoded JSON string
+            if options.key?(:dialog)
+              dialog = options[:dialog]
+              dialog = JSON.dump(dialog) unless dialog.is_a?(String)
+              options = options.merge(dialog: dialog)
+            end
+            post('dialog.open', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -6,10 +6,10 @@ module Slack
       module Endpoints
         module Dnd
           #
-          # Ends the user's currently scheduled Do Not Disturb session immediately.
+          # Ends the current user's 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/dnd.endDnd.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/dnd/dnd.endDnd.json
           def dnd_endDnd(options = {})
             post('dnd.endDnd', options)
           end
@@ -18,42 +18,42 @@ 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/dnd.endSnooze.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/dnd/dnd.endSnooze.json
           def dnd_endSnooze(options = {})
             post('dnd.endSnooze', options)
           end
 
           #
-          # Provides information about a user's current Do Not Disturb settings.
+          # Retrieves a user's current Do Not Disturb status.
           #
           # @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/dnd.info.json
+          # @see https://github.com/slack-ruby/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)
           end
 
           #
-          # Adjusts the snooze duration for a user's Do Not Disturb settings. If a snooze session is not already active for the user, invoking this method will begin one for the specified duration.
+          # Turns on Do Not Disturb mode for the current user, or changes its duration.
           #
           # @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/dnd.setSnooze.json
+          # @see https://github.com/slack-ruby/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)
           end
 
           #
-          # Provides information about the current Do Not Disturb settings for users of a Slack team.
+          # Retrieves the Do Not Disturb status for users on a team.
           #
           # @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/dnd.teamInfo.json
+          # @see https://github.com/slack-ruby/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

@@ -6,10 +6,10 @@ module Slack
       module Endpoints
         module Emoji
           #
-          # This method lists the custom emoji for a team.
+          # Lists 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/emoji.list.json
+          # @see https://github.com/slack-ruby/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

@@ -6,34 +6,48 @@ module Slack
       module Endpoints
         module Files
           #
-          # This method deletes a file from your team.
+          # Deletes a file.
           #
           # @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/files.delete.json
+          # @see https://github.com/slack-ruby/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)
           end
 
           #
-          # This method returns information about a file in your team.
+          # Change the properties of a file (undocumented)
+          #
+          # @option options [Object] :file
+          #   ID of the file to be edited
+          # @option options [Object] :title
+          #   New title of the file
+          # @option options [Object] :filetype
+          #   New filetype of the file. See https://api.slack.com/types/file#file_types for a list of all supported types.
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/undocumented/files/files.edit.json
+          def files_edit(options = {})
+            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
+            throw ArgumentError.new('Required arguments :title missing') if options[:title].nil?
+            post('files.edit', options)
+          end
+
+          #
+          # Gets information about a team file.
           #
           # @option options [file] :file
           #   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/files.info.json
+          # @see https://github.com/slack-ruby/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)
           end
 
           #
-          # This method returns a list of files within the team. It can be filtered and sliced in various ways.
+          # Lists & filters team files.
           #
-          # @option options [user] :user
-          #   Filter files created by a single user.
           # @option options [channel] :channel
           #   Filter files appearing in a specific channel, indicated by its ID.
           # @option options [Object] :ts_from
@@ -54,8 +68,10 @@ module Slack
           #
           #   You can pass multiple values in the types argument, like types=spaces,snippets.The default value is all, which does not filter the list.
           #   .
+          # @option options [user] :user
+          #   Filter files created by a single user.
           # @see https://api.slack.com/methods/files.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.list.json
+          # @see https://github.com/slack-ruby/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]
@@ -63,50 +79,64 @@ module Slack
           end
 
           #
-          # This method disables public/external sharing for a file.
+          # Revokes public/external sharing access 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
+          # @see https://github.com/slack-ruby/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.
+          # Share an existing file in a channel (undocumented)
+          #
+          # @option options [Object] :file
+          #   ID of the file to be shared
+          # @option options [channel] :channel
+          #   Channel to share the file in. Works with both public (channel ID) and private channels (group ID).
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/undocumented/files/files.share.json
+          def files_share(options = {})
+            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            post('files.share', options)
+          end
+
+          #
+          # Enables a file for public/external sharing.
           #
           # @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
+          # @see https://github.com/slack-ruby/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.
+          # Uploads or creates a file.
           #
-          # @option options [file] :file
-          #   File contents via multipart/form-data. If omitting this parameter, you must submit content.
+          # @option options [Object] :channels
+          #   Comma-separated list of channel names or IDs where the file will be shared.
           # @option options [Object] :content
           #   File contents via a POST variable. If omitting this parameter, you must provide a file.
-          # @option options [Object] :filetype
-          #   A file type identifier.
+          # @option options [file] :file
+          #   File contents via multipart/form-data. If omitting this parameter, you must submit content.
           # @option options [Object] :filename
           #   Filename of file.
-          # @option options [Object] :title
-          #   Title of file.
+          # @option options [Object] :filetype
+          #   A file type identifier.
           # @option options [Object] :initial_comment
           #   Initial comment to add to file.
-          # @option options [Object] :channels
-          #   Comma-separated list of channel names or IDs where the file will be shared.
+          # @option options [Object] :title
+          #   Title of file.
           # @see https://api.slack.com/methods/files.upload
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files/files.upload.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.upload.json
           def files_upload(options = {})
-            throw ArgumentError.new('Required arguments :filename missing') if options[:filename].nil?
             post('files.upload', options)
           end
         end

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

@@ -8,27 +8,27 @@ module Slack
           #
           # Add a comment to an existing file.
           #
-          # @option options [file] :file
-          #   File to add a comment to.
           # @option options [Object] :comment
           #   Text of the comment to add.
+          # @option options [file] :file
+          #   File to add a comment to.
           # @see https://api.slack.com/methods/files.comments.add
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files.comments/files.comments.add.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files.comments/files.comments.add.json
           def files_comments_add(options = {})
-            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
             throw ArgumentError.new('Required arguments :comment missing') if options[:comment].nil?
+            throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
             post('files.comments.add', options)
           end
 
           #
-          # Delete an existing comment on a file. Only the original author of the comment or a Team Administrator may delete a file comment.
+          # Deletes an existing comment on a file.
           #
           # @option options [file] :file
           #   File to delete a comment from.
           # @option options [Object] :id
           #   The comment to delete.
           # @see https://api.slack.com/methods/files.comments.delete
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files.comments/files.comments.delete.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files.comments/files.comments.delete.json
           def files_comments_delete(options = {})
             throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
             throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
@@ -36,20 +36,20 @@ module Slack
           end
 
           #
-          # Edit an existing comment on a file. Only the user who created a comment may make edits. Teams may configure a limited time window during which file comment edits are allowed.
+          # Edit an existing file comment.
           #
+          # @option options [Object] :comment
+          #   Text of the comment to edit.
           # @option options [file] :file
           #   File containing the comment to edit.
           # @option options [Object] :id
           #   The comment to edit.
-          # @option options [Object] :comment
-          #   Text of the comment to edit.
           # @see https://api.slack.com/methods/files.comments.edit
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/files.comments/files.comments.edit.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files.comments/files.comments.edit.json
           def files_comments_edit(options = {})
+            throw ArgumentError.new('Required arguments :comment missing') if options[:comment].nil?
             throw ArgumentError.new('Required arguments :file missing') if options[:file].nil?
             throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
-            throw ArgumentError.new('Required arguments :comment missing') if options[:comment].nil?
             post('files.comments.edit', options)
           end
         end