slack-api 1.1.4 → 1.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cd8bee835a10846f099f9d9aae8f23efbab7bc99
-  data.tar.gz: 13741832cb55469cf6ba3599d9b185a2a190480c
+  metadata.gz: 0b03c774ecc1d24801cf2b344799e9d8f7fdc5b0
+  data.tar.gz: 737388b7feb3824d9ab80227e62af24c85eddc6f
 SHA512:
-  metadata.gz: 2edfc9597fe5eb926015a4a0aa40a2dadbd700dcf251616db8587d0710a847946860d9a212bd54961dec64ea3e0c967ff7e2f7ca02f92bc9cdd2cc2fb4cea2e4
-  data.tar.gz: 992f69550c8bc1766f4a69ea13436ba6c625e51ba6a18cbd0c94f084e20599b3572ad2187675caaf9c2cbfe607f293189bf9f10b3f126ed6b57fc7fe16b07e29
+  metadata.gz: 98bb910766b186dca7b9c64dc83e3be66a05914ebbf1ef9fbbebf22b4448ab36d73f92362b3f522b45386c540a7ab5135a341b8b25c62f169b44403e3e42b031
+  data.tar.gz: 99ced9581ef70d927ebc61dbbfe038ed06657ab729b3b41b72fdb2c5f18027e28f0076dd59354f43ed00ab5c9a8b9efce57243b798cd612d227d36701e59e4c7

data/.gitmodules

@@ -1,3 +1,3 @@
 [submodule "slack-api-docs"]
 	path = slack-api-docs
-	url = git@github.com:slackhq/slack-api-docs.git
+	url = git@github.com:aki017/slack-api-docs

data/lib/generators/templates/method.rb.erb

@@ -5,9 +5,11 @@ module Slack
     module <%= group.capitalize %>
 <% names.each do |name, data| %>
       #
-      # <%= data["desc"] %>
+<% data["desc"].lines.each do |l| %>
+      # <%= l.strip %>
+<% end %>
       #
-<% data["args"].each do |arg_name, arg_v| %>
+<% data["args"].reject{|k, v| k=="token"}.each do |arg_name, arg_v| %>
       # @option options [<%= arg_v["type"] %>] :<%= arg_name %>
 <% arg_v["desc"].lines.each do |l| %>
       #   <%= l.strip %>
@@ -17,7 +19,7 @@ module Slack
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/<%= group %>.<%= name %>.md
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/<%= group %>.<%= name %>.json
       def <%= group %>_<%= name %>(options={})
-<% data["args"].select{|k,v| v["required"]}.each do |arg_name, arg_v| %>
+<% data["args"].reject{|k, v| k=="token"}.select{|k,v| v["required"]}.each do |arg_name, arg_v| %>
         throw ArgumentError.new("Required arguments :<%= arg_name %> missing") if options[:<%= arg_name %>].nil?
 <% end %>
         post("<%= group %>.<%= name %>", options)

data/lib/slack/endpoint.rb

@@ -12,6 +12,7 @@ require_relative 'endpoint/oauth'
 require_relative 'endpoint/presence'
 require_relative 'endpoint/search'
 require_relative 'endpoint/stars'
+require_relative 'endpoint/team'
 require_relative 'endpoint/users'
 
 module Slack
@@ -28,6 +29,7 @@ module Slack
     include Presence
     include Search
     include Stars
+    include Team
     include Users
   end
 end

data/lib/slack/endpoint/api.rb

@@ -4,7 +4,7 @@ module Slack
   module Endpoint
     module Api
       #
-      # Checks API calling code.
+      # This method helps you test your calling code.
       #
       # @option options [Object] :error
       #   Error response to return

data/lib/slack/endpoint/auth.rb

@@ -4,7 +4,7 @@ module Slack
   module Endpoint
     module Auth
       #
-      # Checks authentication & identity.
+      # This method checks authentication and tells you who you are.
       #
       # @see https://api.slack.com/methods/auth.test
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/auth.test.md

data/lib/slack/endpoint/channels.rb

@@ -4,9 +4,9 @@ module Slack
   module Endpoint
     module Channels
       #
-      # Archives a channel.
+      # This method archives a channel.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Channel to archive
       # @see https://api.slack.com/methods/channels.archive
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/channels.archive.md
@@ -17,7 +17,7 @@ module Slack
       end
 
       #
-      # Creates a channel.
+      # This method is used to create a channel.
       #
       # @option options [Object] :name
       #   Name of channel to create
@@ -30,14 +30,18 @@ module Slack
       end
 
       #
-      # Fetches history of messages and events from a channel.
+      # This method returns a portion of messages/events from the specified channel.
+      # To read the entire history for a channel, call the method with no latest or
+      # oldest arguments, and then continue paging using the instructions below.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Channel to fetch history for.
-      # @option options [timestamp] :latest
-      #   Latest message timestamp to include in results.
-      # @option options [timestamp] :oldest
-      #   Oldest message timestamp to include in results.
+      # @option options [Object] :latest
+      #   End of time range of messages to include in results.
+      # @option options [Object] :oldest
+      #   Start of time range of messages to include in results.
+      # @option options [Object] :inclusive
+      #   Include messages with latest or oldest timestamp in results.
       # @option options [Object] :count
       #   Number of messages to return, between 1 and 1000.
       # @see https://api.slack.com/methods/channels.history
@@ -49,9 +53,9 @@ module Slack
       end
 
       #
-      # Gets information about a channel.
+      # This method returns information about a team channel.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Channel to get info on
       # @see https://api.slack.com/methods/channels.info
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/channels.info.md
@@ -62,11 +66,11 @@ module Slack
       end
 
       #
-      # Invites a user to a channel.
+      # This method is used to invite a user to a channel. The calling user must be a member of the channel.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Channel to invite user to.
-      # @option options [user] :user
+      # @option options [Object] :user
       #   User to invite to channel.
       # @see https://api.slack.com/methods/channels.invite
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/channels.invite.md
@@ -78,7 +82,8 @@ module Slack
       end
 
       #
-      # Joins a channel, creating it if needed.
+      # This method is used to join a channel. If the channel does not exist, it is
+      # created.
       #
       # @option options [Object] :name
       #   Name of channel to join
@@ -91,11 +96,11 @@ module Slack
       end
 
       #
-      # Removes a user from a channel.
+      # This method allows a user to remove another member from a team channel.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Channel to remove user from.
-      # @option options [user] :user
+      # @option options [Object] :user
       #   User to remove from channel.
       # @see https://api.slack.com/methods/channels.kick
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/channels.kick.md
@@ -107,9 +112,9 @@ module Slack
       end
 
       #
-      # Leaves a channel.
+      # This method is used to leave a channel.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Channel to leave
       # @see https://api.slack.com/methods/channels.leave
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/channels.leave.md
@@ -120,7 +125,9 @@ module Slack
       end
 
       #
-      # Lists all channels in a Slack team.
+      # This method returns a list of all channels in the team. This includes channels the caller is in, channels
+      # they are not currently in, and archived channels. The number of (non-deactivated) members in each channel
+      # is also returned.
       #
       # @option options [Object] :exclude_archived
       #   Don't return archived channels.
@@ -132,11 +139,11 @@ module Slack
       end
 
       #
-      # Sets the read cursor in a channel.
+      # This method moves the read cursor in a channel.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Channel to set reading cursor in.
-      # @option options [timestamp] :ts
+      # @option options [Object] :ts
       #   Timestamp of the most recently seen message.
       # @see https://api.slack.com/methods/channels.mark
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/channels.mark.md
@@ -148,9 +155,9 @@ module Slack
       end
 
       #
-      # Renames a channel.
+      # This method renames a team channel.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Channel to rename
       # @option options [Object] :name
       #   New name for channel.
@@ -164,9 +171,9 @@ module Slack
       end
 
       #
-      # Sets the purpose for a channel.
+      # This method is used to change the purpose of a channel. The calling user must be a member of the channel.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Channel to set the purpose of
       # @option options [Object] :purpose
       #   The new purpose
@@ -180,9 +187,9 @@ module Slack
       end
 
       #
-      # Sets the topic for a channel.
+      # This method is used to change the topic of a channel. The calling user must be a member of the channel.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Channel to set the topic of
       # @option options [Object] :topic
       #   The new topic
@@ -196,9 +203,9 @@ module Slack
       end
 
       #
-      # Unarchives a channel.
+      # This method unarchives a channel. The calling user is added to the channel.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Channel to unarchive
       # @see https://api.slack.com/methods/channels.unarchive
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/channels.unarchive.md

data/lib/slack/endpoint/chat.rb

@@ -4,11 +4,11 @@ module Slack
   module Endpoint
     module Chat
       #
-      # Deletes a message.
+      # This method deletes a message from a channel.
       #
       # @option options [Object] :ts
       #   Timestamp of the message to be deleted.
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Channel containing the message to be deleted.
       # @see https://api.slack.com/methods/chat.delete
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/chat.delete.md
@@ -20,14 +20,16 @@ module Slack
       end
 
       #
-      # Sends a message to a channel.
+      # This method posts a message to a channel.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Channel to send message to. Can be a public channel, private group or IM channel. Can be an encoded ID, or a name.
       # @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.
       # @option options [Object] :link_names
@@ -41,7 +43,7 @@ module Slack
       # @option options [Object] :icon_url
       #   URL to an image to use as the icon for this message
       # @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.
       # @see https://api.slack.com/methods/chat.postMessage
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/chat.postMessage.md
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/chat.postMessage.json
@@ -52,14 +54,14 @@ module Slack
       end
 
       #
-      # Updates a message.
+      # This method updates a message in a channel.
       #
       # @option options [Object] :ts
       #   Timestamp of the message to be updated.
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Channel containing the message to be updated.
       # @option options [Object] :text
-      #   New text for the message, using the [default formatting rules](/docs/formatting).
+      #   New text for the message, using the default formatting rules.
       # @see https://api.slack.com/methods/chat.update
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/chat.update.md
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/chat.update.json

data/lib/slack/endpoint/emoji.rb

@@ -4,7 +4,7 @@ module Slack
   module Endpoint
     module Emoji
       #
-      # Lists custom emoji for a team.
+      # This method lists the custom emoji for a team.
       #
       # @see https://api.slack.com/methods/emoji.list
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/emoji.list.md

data/lib/slack/endpoint/files.rb

@@ -4,10 +4,27 @@ module Slack
   module Endpoint
     module Files
       #
-      # Gets information about a team file.
+      # This method deletes a file from your team.
       #
-      # @option options [file] :file
+      # @option options [Object] :file
+      #   ID of file to delete.
+      # @see https://api.slack.com/methods/files.delete
+      # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/files.delete.md
+      # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/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.
+      #
+      # @option options [Object] :file
       #   File to fetch info for
+      # @option options [Object] :count
+      #   Number of items to return per page.
+      # @option options [Object] :page
+      #   Page number of results to return.
       # @see https://api.slack.com/methods/files.info
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/files.info.md
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/files.info.json
@@ -17,9 +34,9 @@ module Slack
       end
 
       #
-      # Lists & filters team files.
+      # This method returns a list of files within the team. It can be filtered and sliced in various ways.
       #
-      # @option options [user] :user
+      # @option options [Object] :user
       #   Filter files created by a single user.
       # @option options [Object] :ts_from
       #   Filter files created after this timestamp (inclusive).
@@ -28,15 +45,21 @@ module Slack
       # @option options [Object] :types
       #   Filter files by type:
       #   
-      #   * `all` - All files
-      #   * `posts` - Posts
-      #   * `snippets` - Snippets
-      #   * `images` - Image files
-      #   * `gdocs` - Google docs
-      #   * `zips` - Zip files
-      #   * `pdfs` - PDF files
       #   
-      #   You can pass multiple values in the types argument, like `types=posts,snippets`.The default value is `all`, which does not filter the list.
+      #   all - All files
+      #   posts - Posts
+      #   snippets - Snippets
+      #   images - Image files
+      #   gdocs - Google docs
+      #   zips - Zip files
+      #   pdfs - PDF files
+      #   
+      #   
+      #   You can pass multiple values in the types argument, like types=posts,snippets.The default value is all, which does not filter the list.
+      # @option options [Object] :count
+      #   Number of items to return per page.
+      # @option options [Object] :page
+      #   Page number of results to return.
       # @see https://api.slack.com/methods/files.list
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/files.list.md
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/files.list.json
@@ -45,10 +68,10 @@ module Slack
       end
 
       #
-      # Uploads or creates a file.
+      # This method allows you to create or upload an existing file.
       #
       # @option options [Object] :file
-      #   File contents via `multipart/form-data`.
+      #   File contents via multipart/form-data.
       # @option options [Object] :content
       #   File contents via a POST var.
       # @option options [Object] :filetype
@@ -59,7 +82,7 @@ module Slack
       #   Title of file.
       # @option options [Object] :initial_comment
       #   Initial comment to add to file.
-      # @option options [channel] :channels
+      # @option options [Object] :channels
       #   Comma separated list of channels to share the file into.
       # @see https://api.slack.com/methods/files.upload
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/files.upload.md

data/lib/slack/endpoint/groups.rb

@@ -4,9 +4,9 @@ module Slack
   module Endpoint
     module Groups
       #
-      # Archives a private group.
+      # This method archives a private group.
       #
-      # @option options [group] :channel
+      # @option options [Object] :channel
       #   Private group to archive
       # @see https://api.slack.com/methods/groups.archive
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/groups.archive.md
@@ -17,9 +17,9 @@ module Slack
       end
 
       #
-      # Closes a private group.
+      # This method closes a private group.
       #
-      # @option options [group] :channel
+      # @option options [Object] :channel
       #   Group to open.
       # @see https://api.slack.com/methods/groups.close
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/groups.close.md
@@ -30,7 +30,7 @@ module Slack
       end
 
       #
-      # Creates a private group.
+      # This method creates a private group.
       #
       # @option options [Object] :name
       #   Name of group to create
@@ -43,9 +43,9 @@ module Slack
       end
 
       #
-      # Clones and archives a private group.
+      # This method takes an existing private group and performs the following steps:
       #
-      # @option options [group] :channel
+      # @option options [Object] :channel
       #   Group to clone and archive.
       # @see https://api.slack.com/methods/groups.createChild
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/groups.createChild.md
@@ -56,14 +56,18 @@ module Slack
       end
 
       #
-      # Fetches history of messages and events from a private group.
+      # This method returns a portion of messages/events from the specified private group.
+      # To read the entire history for a group, call the method with no latest or
+      # oldest arguments, and then continue paging using the instructions below.
       #
-      # @option options [group] :channel
+      # @option options [Object] :channel
       #   Group to fetch history for.
-      # @option options [timestamp] :latest
-      #   Latest message timestamp to include in results.
-      # @option options [timestamp] :oldest
-      #   Oldest message timestamp to include in results.
+      # @option options [Object] :latest
+      #   End of time range of messages to include in results.
+      # @option options [Object] :oldest
+      #   Start of time range of messages to include in results.
+      # @option options [Object] :inclusive
+      #   Include messages with latest or oldest timestamp in results.
       # @option options [Object] :count
       #   Number of messages to return, between 1 and 1000.
       # @see https://api.slack.com/methods/groups.history
@@ -75,11 +79,24 @@ module Slack
       end
 
       #
-      # Invites a user to a private group.
+      # This method returns information about a private group.
       #
-      # @option options [group] :channel
+      # @option options [Object] :channel
+      #   Group to get info on
+      # @see https://api.slack.com/methods/groups.info
+      # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/groups.info.md
+      # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/groups.info.json
+      def groups_info(options={})
+        throw ArgumentError.new("Required arguments :channel missing") if options[:channel].nil?
+        post("groups.info", options)
+      end
+
+      #
+      # This method is used to invite a user to a private group. The calling user must be a member of the group.
+      #
+      # @option options [Object] :channel
       #   Private group to invite user to.
-      # @option options [user] :user
+      # @option options [Object] :user
       #   User to invite.
       # @see https://api.slack.com/methods/groups.invite
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/groups.invite.md
@@ -91,11 +108,11 @@ module Slack
       end
 
       #
-      # Removes a user from a private group.
+      # This method allows a user to remove another member from a private group.
       #
-      # @option options [group] :channel
+      # @option options [Object] :channel
       #   Group to remove user from.
-      # @option options [user] :user
+      # @option options [Object] :user
       #   User to remove from group.
       # @see https://api.slack.com/methods/groups.kick
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/groups.kick.md
@@ -107,9 +124,9 @@ module Slack
       end
 
       #
-      # Leaves a private group.
+      # This method is used to leave a private group.
       #
-      # @option options [group] :channel
+      # @option options [Object] :channel
       #   Group to leave
       # @see https://api.slack.com/methods/groups.leave
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/groups.leave.md
@@ -120,7 +137,8 @@ module Slack
       end
 
       #
-      # Lists private groups that the calling user has access to.
+      # This method returns a list of groups in the team that the caller is in and archived groups that the caller was in.
+      # The list of (non-deactivated) members in each group is also returned.
       #
       # @option options [Object] :exclude_archived
       #   Don't return archived groups.
@@ -132,11 +150,11 @@ module Slack
       end
 
       #
-      # Sets the read cursor in a private group.
+      # This method moves the read cursor in a private group.
       #
-      # @option options [group] :channel
+      # @option options [Object] :channel
       #   Group to set reading cursor in.
-      # @option options [timestamp] :ts
+      # @option options [Object] :ts
       #   Timestamp of the most recently seen message.
       # @see https://api.slack.com/methods/groups.mark
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/groups.mark.md
@@ -148,9 +166,9 @@ module Slack
       end
 
       #
-      # Opens a private group.
+      # This method opens a private group.
       #
-      # @option options [group] :channel
+      # @option options [Object] :channel
       #   Group to open.
       # @see https://api.slack.com/methods/groups.open
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/groups.open.md
@@ -161,9 +179,9 @@ module Slack
       end
 
       #
-      # Renames a private group.
+      # This method renames a private group.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Group to rename
       # @option options [Object] :name
       #   New name for group.
@@ -177,9 +195,9 @@ module Slack
       end
 
       #
-      # Sets the purpose for a private group.
+      # This method is used to change the purpose of a private group. The calling user must be a member of the private group.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Private group to set the purpose of
       # @option options [Object] :purpose
       #   The new purpose
@@ -193,9 +211,9 @@ module Slack
       end
 
       #
-      # Sets the topic for a private group.
+      # This method is used to change the topic of a private group. The calling user must be a member of the private group.
       #
-      # @option options [channel] :channel
+      # @option options [Object] :channel
       #   Private group to set the topic of
       # @option options [Object] :topic
       #   The new topic
@@ -209,9 +227,9 @@ module Slack
       end
 
       #
-      # Unarchives a private group.
+      # This method unarchives a private group.
       #
-      # @option options [group] :channel
+      # @option options [Object] :channel
       #   Group to unarchive
       # @see https://api.slack.com/methods/groups.unarchive
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/groups.unarchive.md

data/lib/slack/endpoint/im.rb

@@ -4,9 +4,9 @@ module Slack
   module Endpoint
     module Im
       #
-      # Close a direct message channel.
+      # This method closes a direct message channel.
       #
-      # @option options [im] :channel
+      # @option options [Object] :channel
       #   Direct message channel to close.
       # @see https://api.slack.com/methods/im.close
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/im.close.md
@@ -17,14 +17,18 @@ module Slack
       end
 
       #
-      # Fetches history of messages and events from direct message channel.
+      # This method returns a portion of messages/events from the specified direct message channel.
+      # To read the entire history for a direct message channel, call the method with no latest or
+      # oldest arguments, and then continue paging using the instructions below.
       #
-      # @option options [im] :channel
+      # @option options [Object] :channel
       #   Direct message channel to fetch history for.
-      # @option options [timestamp] :latest
-      #   Latest message timestamp to include in results.
-      # @option options [timestamp] :oldest
-      #   Oldest message timestamp to include in results.
+      # @option options [Object] :latest
+      #   End of time range of messages to include in results.
+      # @option options [Object] :oldest
+      #   Start of time range of messages to include in results.
+      # @option options [Object] :inclusive
+      #   Include messages with latest or oldest timestamp in results.
       # @option options [Object] :count
       #   Number of messages to return, between 1 and 1000.
       # @see https://api.slack.com/methods/im.history
@@ -36,7 +40,7 @@ module Slack
       end
 
       #
-      # Lists direct message channels for the calling user.
+      # This method returns a list of all im channels that the user has.
       #
       # @see https://api.slack.com/methods/im.list
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/im.list.md
@@ -46,11 +50,11 @@ module Slack
       end
 
       #
-      # Sets the read cursor in a direct message channel.
+      # This method moves the read cursor in a direct message channel.
       #
-      # @option options [im] :channel
+      # @option options [Object] :channel
       #   Direct message channel to set reading cursor in.
-      # @option options [timestamp] :ts
+      # @option options [Object] :ts
       #   Timestamp of the most recently seen message.
       # @see https://api.slack.com/methods/im.mark
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/im.mark.md
@@ -62,9 +66,9 @@ module Slack
       end
 
       #
-      # Opens a direct message channel.
+      # This method opens a direct message channel with another member of your Slack team.
       #
-      # @option options [user] :user
+      # @option options [Object] :user
       #   User to open a direct message channel with.
       # @see https://api.slack.com/methods/im.open
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/im.open.md

data/lib/slack/endpoint/oauth.rb

@@ -4,14 +4,15 @@ module Slack
   module Endpoint
     module Oauth
       #
-      # Exchanges a temporary OAuth code for an API token.
+      # This method allows you to exchange a temporary OAuth code for an API access token.
+      # This is used as part of the OAuth authentication flow.
       #
       # @option options [Object] :client_id
       #   Issued when you created your application.
       # @option options [Object] :client_secret
       #   Issued when you created your application.
       # @option options [Object] :code
-      #   The `code` param returned via the OAuth callback.
+      #   The code param returned via the OAuth callback.
       # @option options [Object] :redirect_uri
       #   This must match the originally submitted URI (if one was sent).
       # @see https://api.slack.com/methods/oauth.access

data/lib/slack/endpoint/search.rb

@@ -4,16 +4,20 @@ module Slack
   module Endpoint
     module Search
       #
-      # Searches for messages and files matching a query.
+      # This method allows to to search both messages and files in a single call.
       #
       # @option options [Object] :query
       #   Search query. May contains booleans, etc.
       # @option options [Object] :sort
-      #   Return matches sorted by either `score` or `timestamp`.
+      #   Return matches sorted by either score or timestamp.
       # @option options [Object] :sort_dir
-      #   Change sort direction to ascending (`asc`) or descending (`desc`).
+      #   Change sort direction to ascending (asc) or descending (desc).
       # @option options [Object] :highlight
-      #   Pass a value of `1` to enable query highlight markers (see below).
+      #   Pass a value of 1 to enable query highlight markers (see below).
+      # @option options [Object] :count
+      #   Number of items to return per page.
+      # @option options [Object] :page
+      #   Page number of results to return.
       # @see https://api.slack.com/methods/search.all
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/search.all.md
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/search.all.json
@@ -23,16 +27,20 @@ module Slack
       end
 
       #
-      # Searches for files matching a query.
+      # This method returns files matching a search query.
       #
       # @option options [Object] :query
-      #   Search query. May contains booleans, etc.
+      #   Search query. May contain booleans, etc.
       # @option options [Object] :sort
-      #   Return matches sorted by either `score` or `timestamp`.
+      #   Return matches sorted by either score or timestamp.
       # @option options [Object] :sort_dir
-      #   Change sort direction to ascending (`asc`) or descending (`desc`).
+      #   Change sort direction to ascending (asc) or descending (desc).
       # @option options [Object] :highlight
-      #   Pass a value of `1` to enable query highlight markers (see below).
+      #   Pass a value of 1 to enable query highlight markers (see below).
+      # @option options [Object] :count
+      #   Number of items to return per page.
+      # @option options [Object] :page
+      #   Page number of results to return.
       # @see https://api.slack.com/methods/search.files
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/search.files.md
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/search.files.json
@@ -42,16 +50,20 @@ module Slack
       end
 
       #
-      # Searches for messages matching a query.
+      # This method returns messages matching a search query.
       #
       # @option options [Object] :query
       #   Search query. May contains booleans, etc.
       # @option options [Object] :sort
-      #   Return matches sorted by either `score` or `timestamp`.
+      #   Return matches sorted by either score or timestamp.
       # @option options [Object] :sort_dir
-      #   Change sort direction to ascending (`asc`) or descending (`desc`).
+      #   Change sort direction to ascending (asc) or descending (desc).
       # @option options [Object] :highlight
-      #   Pass a value of `1` to enable query highlight markers (see below).
+      #   Pass a value of 1 to enable query highlight markers (see below).
+      # @option options [Object] :count
+      #   Number of items to return per page.
+      # @option options [Object] :page
+      #   Page number of results to return.
       # @see https://api.slack.com/methods/search.messages
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/search.messages.md
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/search.messages.json

data/lib/slack/endpoint/stars.rb

@@ -4,10 +4,14 @@ module Slack
   module Endpoint
     module Stars
       #
-      # Lists stars for a user.
+      # This method lists the items starred by a user.
       #
-      # @option options [user] :user
+      # @option options [Object] :user
       #   Show stars by this user. Defaults to the authed user.
+      # @option options [Object] :count
+      #   Number of items to return per page.
+      # @option options [Object] :page
+      #   Page number of results to return.
       # @see https://api.slack.com/methods/stars.list
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/stars.list.md
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/stars.list.json

data/lib/slack/endpoint/team.rb

@@ -0,0 +1,32 @@
+# This file was auto-generated by lib/generators/tasks/generate.rb
+
+module Slack
+  module Endpoint
+    module Team
+      #
+      # This method is used to get the access logs for users on a team.
+      #
+      # @option options [Object] :count
+      #   Number of items to return per page.
+      # @option options [Object] :page
+      #   Page number of results to return.
+      # @see https://api.slack.com/methods/team.accessLogs
+      # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/team.accessLogs.md
+      # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/team.accessLogs.json
+      def team_accessLogs(options={})
+        post("team.accessLogs", options)
+      end
+
+      #
+      # This method provides information about your team.
+      #
+      # @see https://api.slack.com/methods/team.info
+      # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/team.info.md
+      # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/team.info.json
+      def team_info(options={})
+        post("team.info", options)
+      end
+
+    end
+  end
+end

data/lib/slack/endpoint/users.rb

@@ -4,9 +4,10 @@ module Slack
   module Endpoint
     module Users
       #
-      # Gets user presence information.
+      # This method lets you find out information about a user's presence.
+      # Consult the presence documentation for more details.
       #
-      # @option options [user] :user
+      # @option options [Object] :user
       #   User to get presence info on. Defaults to the authed user.
       # @see https://api.slack.com/methods/users.getPresence
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/users.getPresence.md
@@ -17,9 +18,9 @@ module Slack
       end
 
       #
-      # Gets information about a user.
+      # This method returns information about a team member.
       #
-      # @option options [user] :user
+      # @option options [Object] :user
       #   User to get info on
       # @see https://api.slack.com/methods/users.info
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/users.info.md
@@ -30,7 +31,7 @@ module Slack
       end
 
       #
-      # Lists all users in a Slack team.
+      # This method returns a list of all users in the team. This includes deleted/deactivated users.
       #
       # @see https://api.slack.com/methods/users.list
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/users.list.md
@@ -40,7 +41,9 @@ module Slack
       end
 
       #
-      # Marks a user as active.
+      # This method lets the slack messaging server know that the authenticated user
+      # is currently active. Consult the presence documentation for
+      # more details.
       #
       # @see https://api.slack.com/methods/users.setActive
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/users.setActive.md
@@ -50,10 +53,11 @@ module Slack
       end
 
       #
-      # Manually sets user presence.
+      # This method lets you set the calling user's manual presence.
+      # Consult the presence documentation for more details.
       #
       # @option options [Object] :presence
-      #   Either `auto` or `away`
+      #   Either auto or away
       # @see https://api.slack.com/methods/users.setPresence
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/users.setPresence.md
       # @see https://github.com/slackhq/slack-api-docs/blob/master/methods/users.setPresence.json

data/lib/slack/version.rb

@@ -1,3 +1,3 @@
 module Slack
-  VERSION = "1.1.4"
+  VERSION = "1.1.6"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: slack-api
 version: !ruby/object:Gem::Version
-  version: 1.1.4
+  version: 1.1.6
 platform: ruby
 authors:
 - aki017
@@ -286,6 +286,7 @@ files:
 - lib/slack/endpoint/presence.rb
 - lib/slack/endpoint/search.rb
 - lib/slack/endpoint/stars.rb
+- lib/slack/endpoint/team.rb
 - lib/slack/endpoint/users.rb
 - lib/slack/error.rb
 - lib/slack/realtime/client.rb