slack-ruby-client 0.17.0 → 1.0.0

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

@@ -31,7 +31,7 @@ module Slack
           #   Channel containing the message to be deleted.
           # @option options [timestamp] :ts
           #   Timestamp of the message to be deleted.
-          # @option options [Object] :as_user
+          # @option options [boolean] :as_user
           #   Pass true to delete the message as the authed user with chat:write:user scope. Bot users in this context are considered authed users. If unused or false, the message will be deleted with chat:write:bot scope.
           # @see https://api.slack.com/methods/chat.delete
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.delete.json
@@ -47,9 +47,9 @@ module Slack
           #
           # @option options [channel] :channel
           #   The channel the scheduled_message is posting to.
-          # @option options [Object] :scheduled_message_id
+          # @option options [string] :scheduled_message_id
           #   scheduled_message_id returned from call to chat.scheduleMessage.
-          # @option options [Object] :as_user
+          # @option options [boolean] :as_user
           #   Pass true to delete the message as the authed user with chat:write:user scope. Bot users in this context are considered authed users. If unused or false, the message will be deleted with chat:write:bot scope.
           # @see https://api.slack.com/methods/chat.deleteScheduledMessage
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.deleteScheduledMessage.json
@@ -65,7 +65,7 @@ module Slack
           #
           # @option options [channel] :channel
           #   The ID of the conversation or channel containing the message.
-          # @option options [Object] :message_ts
+          # @option options [string] :message_ts
           #   A message's ts value, uniquely identifying it within a channel.
           # @see https://api.slack.com/methods/chat.getPermalink
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.getPermalink.json
@@ -81,7 +81,7 @@ module Slack
           #
           # @option options [channel] :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
+          # @option options [string] :text
           #   Text of the message to send.
           # @see https://api.slack.com/methods/chat.meMessage
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.meMessage.json
@@ -94,29 +94,29 @@ module Slack
           #
           # Sends an ephemeral message to a user in a channel.
           #
-          # @option options [Object] :attachments
-          #   A JSON-based array of structured attachments, presented as a URL-encoded string.
           # @option options [channel] :channel
           #   Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name.
-          # @option options [Object] :text
+          # @option options [string] :text
           #   How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.
           # @option options [user] :user
           #   id of the user who will receive the ephemeral message. The user should be in the channel specified by the channel argument.
-          # @option options [Object] :as_user
+          # @option options [boolean] :as_user
           #   Pass true to post the message as the authed user. Defaults to true if the chat:write:bot scope is not included. Otherwise, defaults to false.
-          # @option options [Object] :blocks
+          # @option options [string] :attachments
+          #   A JSON-based array of structured attachments, presented as a URL-encoded string.
+          # @option options [blocks[] as string] :blocks
           #   A JSON-based array of structured blocks, presented as a URL-encoded string.
-          # @option options [Object] :icon_emoji
+          # @option options [string] :icon_emoji
           #   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.
-          # @option options [Object] :icon_url
+          # @option options [string] :icon_url
           #   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] :link_names
+          # @option options [boolean] :link_names
           #   Find and link channel names and usernames.
-          # @option options [Object] :parse
+          # @option options [string] :parse
           #   Change how messages are treated. Defaults to none. See below.
-          # @option options [Object] :thread_ts
+          # @option options [string] :thread_ts
           #   Provide another message's ts value to post this message in a thread. Avoid using a reply's ts value; use its parent's value instead. Ephemeral messages in threads are only shown if there is already an active thread.
-          # @option options [Object] :username
+          # @option options [string] :username
           #   Set your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
           # @see https://api.slack.com/methods/chat.postEphemeral
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postEphemeral.json
@@ -145,35 +145,33 @@ module Slack
           #
           # @option options [channel] :channel
           #   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] :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] :attachments
+          # @option options [string] :attachments
           #   A JSON-based array of structured attachments, presented as a URL-encoded string.
-          # @option options [Object] :blocks
+          # @option options [blocks[] as string] :blocks
           #   A JSON-based array of structured blocks, presented as a URL-encoded string.
-          # @option options [Object] :draft_id
-          #   The id of the draft associated with the message.
-          # @option options [Object] :icon_emoji
+          # @option options [string] :text
+          #   The formatted text of the message to be published. If blocks are included, this will become the fallback text used in notifications.
+          # @option options [boolean] :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 [string] :icon_emoji
           #   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.
-          # @option options [Object] :icon_url
+          # @option options [string] :icon_url
           #   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] :link_names
+          # @option options [boolean] :link_names
           #   Find and link channel names and usernames.
-          # @option options [Object] :mrkdwn
+          # @option options [boolean] :mrkdwn
           #   Disable Slack markup parsing by setting to false. Enabled by default.
-          # @option options [Object] :parse
+          # @option options [string] :parse
           #   Change how messages are treated. Defaults to none. See below.
-          # @option options [Object] :reply_broadcast
+          # @option options [boolean] :reply_broadcast
           #   Used in conjunction with thread_ts and indicates whether reply should be made visible to everyone in the channel or conversation. Defaults to false.
-          # @option options [Object] :text
-          #   How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.
-          # @option options [Object] :thread_ts
+          # @option options [string] :thread_ts
           #   Provide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead.
-          # @option options [Object] :unfurl_links
+          # @option options [boolean] :unfurl_links
           #   Pass true to enable unfurling of primarily text-based content.
-          # @option options [Object] :unfurl_media
+          # @option options [boolean] :unfurl_media
           #   Pass false to disable unfurling of media content.
-          # @option options [Object] :username
+          # @option options [string] :username
           #   Set your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
           # @see https://api.slack.com/methods/chat.postMessage
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postMessage.json
@@ -200,27 +198,27 @@ module Slack
           #
           # @option options [channel] :channel
           #   Channel, private group, or DM channel to send message to. Can be an encoded ID, or a name. See below for more details.
-          # @option options [Object] :post_at
+          # @option options [integer] :post_at
           #   Unix EPOCH timestamp of time in future to send the message.
-          # @option options [Object] :text
+          # @option options [string] :text
           #   How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.
-          # @option options [Object] :as_user
+          # @option options [boolean] :as_user
           #   Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See chat.postMessage.
-          # @option options [Object] :attachments
+          # @option options [string] :attachments
           #   A JSON-based array of structured attachments, presented as a URL-encoded string.
-          # @option options [Object] :blocks
+          # @option options [blocks[] as string] :blocks
           #   A JSON-based array of structured blocks, presented as a URL-encoded string.
-          # @option options [Object] :link_names
+          # @option options [boolean] :link_names
           #   Find and link channel names and usernames.
-          # @option options [Object] :parse
+          # @option options [string] :parse
           #   Change how messages are treated. Defaults to none. See chat.postMessage.
-          # @option options [Object] :reply_broadcast
+          # @option options [boolean] :reply_broadcast
           #   Used in conjunction with thread_ts and indicates whether reply should be made visible to everyone in the channel or conversation. Defaults to false.
-          # @option options [Object] :thread_ts
+          # @option options [string] :thread_ts
           #   Provide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead.
-          # @option options [Object] :unfurl_links
+          # @option options [boolean] :unfurl_links
           #   Pass true to enable unfurling of primarily text-based content.
-          # @option options [Object] :unfurl_media
+          # @option options [boolean] :unfurl_media
           #   Pass false to disable unfurling of media content.
           # @see https://api.slack.com/methods/chat.scheduleMessage
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.scheduleMessage.json
@@ -235,16 +233,20 @@ module Slack
           # Provide custom unfurl behavior for user-posted URLs
           #
           # @option options [channel] :channel
-          #   Channel ID of the message.
+          #   Channel ID of the message. Both channel and ts must be provided together, or unfurl_id and source must be provided together.
           # @option options [timestamp] :ts
           #   Timestamp of the message to add unfurl behavior to.
-          # @option options [Object] :unfurls
+          # @option options [string] :unfurls
           #   URL-encoded JSON map with keys set to URLs featured in the the message, pointing to their unfurl blocks or message attachments.
+          # @option options [string] :source
+          #   The source of the link to unfurl. The source may either be composer, when the link is inside the message composer, or conversations_history, when the link has been posted to a conversation.
+          # @option options [string] :unfurl_id
+          #   The ID of the link to unfurl. Both unfurl_id and source must be provided together, or channel and ts must be provided together.
           # @option options [Object] :user_auth_blocks
           #   Provide a JSON based array of structured blocks presented as URL-encoded string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior.
           # @option options [Object] :user_auth_message
           #   Provide a simply-formatted string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior. Provides two buttons, Not now or Never ask me again.
-          # @option options [Object] :user_auth_required
+          # @option options [boolean] :user_auth_required
           #   Set to true or 1 to indicate the user must install your Slack app to trigger unfurls for this domain.
           # @option options [Object] :user_auth_url
           #   Send users to this custom URL where they will complete authentication in your app to fully trigger unfurling. Value should be properly URL-encoded.
@@ -265,17 +267,21 @@ module Slack
           #   Channel containing the message to be updated.
           # @option options [timestamp] :ts
           #   Timestamp of the message to be updated.
-          # @option options [Object] :as_user
+          # @option options [boolean] :as_user
           #   Pass true to update the message as the authed user. Bot users in this context are considered authed users.
-          # @option options [Object] :attachments
+          # @option options [string] :attachments
           #   A JSON-based array of structured attachments, presented as a URL-encoded string. This field is required when not presenting text. If you don't include this field, the message's previous attachments will be retained. To remove previous attachments, include an empty array for this field.
-          # @option options [Object] :blocks
+          # @option options [blocks[] as string] :blocks
           #   A JSON-based array of structured blocks, presented as a URL-encoded string. If you don't include this field, the message's previous blocks will be retained. To remove previous blocks, include an empty array for this field.
-          # @option options [Object] :link_names
+          # @option options [array] :file_ids
+          #   Array of new file ids that will be sent with this message.
+          # @option options [boolean] :link_names
           #   Find and link channel names and usernames. Defaults to none. If you do not specify a value for this field, the original value set for the message will be overwritten with the default, none.
-          # @option options [Object] :parse
+          # @option options [string] :parse
           #   Change how messages are treated. Defaults to client, unlike chat.postMessage. Accepts either none or full. If you do not specify a value for this field, the original value set for the message will be overwritten with the default, client.
-          # @option options [Object] :text
+          # @option options [boolean] :reply_broadcast
+          #   Broadcast an existing thread reply to make it visible to everyone in the channel or conversation.
+          # @option options [string] :text
           #   New text for the message, using the default formatting rules. It's not required when presenting blocks or attachments.
           # @see https://api.slack.com/methods/chat.update
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.update.json

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

@@ -11,15 +11,15 @@ module Slack
           #
           # @option options [channel] :channel
           #   The channel of the scheduled messages.
-          # @option options [Object] :cursor
+          # @option options [string] :cursor
           #   For pagination purposes, this is the cursor value returned from a previous call to chat.scheduledmessages.list indicating where you want to start this call from.
           # @option options [timestamp] :latest
           #   A UNIX timestamp of the latest value in the time range.
-          # @option options [Object] :limit
+          # @option options [integer] :limit
           #   Maximum number of original entries to return.
           # @option options [timestamp] :oldest
           #   A UNIX timestamp of the oldest value in the time range.
-          # @option options [Object] :team_id
+          # @option options [string] :team_id
           #   encoded team id to list channels in, required if org token is used.
           # @see https://api.slack.com/methods/chat.scheduledMessages.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat.scheduledMessages/chat.scheduledMessages.list.json

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

@@ -6,6 +6,42 @@ module Slack
     module Api
       module Endpoints
         module Conversations
+          #
+          # Accepts an invitation to a Slack Connect channel.
+          #
+          # @option options [string] :channel_name
+          #   Name of the channel. If the channel does not exist already in your workspace, this name is the one that the channel will take.
+          # @option options [Object] :channel_id
+          #   ID of the channel that you'd like to accept. Must provide either invite_id or channel_id.
+          # @option options [boolean] :free_trial_accepted
+          #   Whether you'd like to use your workspace's free trial to begin using Slack Connect.
+          # @option options [Object] :invite_id
+          #   See the shared_channel_invite_received event payload for more details on how to retrieve the ID of the invitation.
+          # @option options [boolean] :is_private
+          #   Whether the channel should be private.
+          # @option options [string] :team_id
+          #   The ID of the workspace to accept the channel in. If an org-level token is used to call this method, the team_id argument is required.
+          # @see https://api.slack.com/methods/conversations.acceptSharedInvite
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.acceptSharedInvite.json
+          def conversations_acceptSharedInvite(options = {})
+            throw ArgumentError.new('Required arguments :channel_name missing') if options[:channel_name].nil?
+            post('conversations.acceptSharedInvite', options)
+          end
+
+          #
+          # Approves an invitation to a Slack Connect channel
+          #
+          # @option options [Object] :invite_id
+          #   ID of the shared channel invite to approve.
+          # @option options [Object] :target_team
+          #   The team or enterprise id of the other party involved in the invitation you are approving.
+          # @see https://api.slack.com/methods/conversations.approveSharedInvite
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.approveSharedInvite.json
+          def conversations_approveSharedInvite(options = {})
+            throw ArgumentError.new('Required arguments :invite_id missing') if options[:invite_id].nil?
+            post('conversations.approveSharedInvite', options)
+          end
+
           #
           # Archives a conversation.
           #
@@ -35,11 +71,11 @@ module Slack
           #
           # Initiates a public or private channel-based conversation
           #
-          # @option options [Object] :name
+          # @option options [string] :name
           #   Name of the public or private channel to create.
-          # @option options [Object] :is_private
+          # @option options [boolean] :is_private
           #   Create a private channel instead of a public one.
-          # @option options [Object] :team_id
+          # @option options [string] :team_id
           #   encoded team id to create the channel in, required if org token is used.
           # @see https://api.slack.com/methods/conversations.create
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.create.json
@@ -48,18 +84,32 @@ module Slack
             post('conversations.create', options)
           end
 
+          #
+          # Declines a Slack Connect channel invite.
+          #
+          # @option options [Object] :invite_id
+          #   ID of the Slack Connect invite to decline. Subscribe to the shared_channel_invite_accepted event to receive IDs of Slack Connect channel invites that have been accepted and are awaiting approval.
+          # @option options [Object] :target_team
+          #   The team or enterprise id of the other party involved in the invitation you are declining.
+          # @see https://api.slack.com/methods/conversations.declineSharedInvite
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.declineSharedInvite.json
+          def conversations_declineSharedInvite(options = {})
+            throw ArgumentError.new('Required arguments :invite_id missing') if options[:invite_id].nil?
+            post('conversations.declineSharedInvite', 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
+          # @option options [string] :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] :inclusive
+          # @option options [boolean] :inclusive
           #   Include messages with latest or oldest timestamp in results only when either timestamp is specified.
           # @option options [timestamp] :latest
-          #   End of time range of messages to include in results.
-          # @option options [Object] :limit
+          #   End of time range of messages to include in results. Default is the current time.
+          # @option options [number] :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.
@@ -82,9 +132,9 @@ module Slack
           #
           # @option options [channel] :channel
           #   Conversation ID to learn more about.
-          # @option options [Object] :include_locale
+          # @option options [boolean] :include_locale
           #   Set this to true to receive the locale for this conversation. Defaults to false.
-          # @option options [Object] :include_num_members
+          # @option options [boolean] :include_num_members
           #   Set to true to include the member count for the specified 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
@@ -99,7 +149,7 @@ module Slack
           #
           # @option options [channel] :channel
           #   The ID of the public or private channel to invite user(s) to.
-          # @option options [Object] :users
+          # @option options [string] :users
           #   A comma separated list of user IDs. Up to 1000 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
@@ -110,6 +160,25 @@ module Slack
             post('conversations.invite', options)
           end
 
+          #
+          # Sends an invitation to a Slack Connect channel
+          #
+          # @option options [channel] :channel
+          #   ID of the channel on your team that you'd like to share.
+          # @option options [array] :emails
+          #   Optional email to receive this invite. Either emails or user_ids must be provided.
+          # @option options [boolean] :external_limited
+          #   Optional boolean on whether invite is to a external limited member. Defaults to true.
+          # @option options [array] :user_ids
+          #   Optional user_id to receive this invite. Either emails or user_ids must be provided.
+          # @see https://api.slack.com/methods/conversations.inviteShared
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.inviteShared.json
+          def conversations_inviteShared(options = {})
+            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
+            post('conversations.inviteShared', options)
+          end
+
           #
           # Joins an existing conversation.
           #
@@ -156,15 +225,15 @@ module Slack
           #
           # Lists all channels in a Slack team.
           #
-          # @option options [Object] :cursor
+          # @option options [string] :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
+          # @option options [boolean] :exclude_archived
           #   Set to true to exclude archived channels from the list.
-          # @option options [Object] :limit
+          # @option options [number] :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] :team_id
+          # @option options [string] :team_id
           #   encoded team id to list channels in, required if token belongs to org-wide app.
-          # @option options [Object] :types
+          # @option options [string] :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
@@ -178,6 +247,25 @@ module Slack
             end
           end
 
+          #
+          # Lists shared channel invites that have been generated or received but have not been approved by all parties
+          #
+          # @option options [string] :cursor
+          #   Set to next_cursor returned by previous call to list items in subsequent page.
+          # @option options [string] :team_id
+          #   Encoded team id for the workspace to retrieve invites for, required if org token is used.
+          # @see https://api.slack.com/methods/conversations.listConnectInvites
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.listConnectInvites.json
+          def conversations_listConnectInvites(options = {})
+            if block_given?
+              Pagination::Cursor.new(self, :conversations_listConnectInvites, options).each do |page|
+                yield page
+              end
+            else
+              post('conversations.listConnectInvites', options)
+            end
+          end
+
           #
           # Sets the read cursor in a channel.
           #
@@ -199,9 +287,9 @@ module Slack
           #
           # @option options [channel] :channel
           #   ID of the conversation to retrieve members for.
-          # @option options [Object] :cursor
+          # @option options [string] :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
+          # @option options [number] :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
@@ -222,9 +310,11 @@ module Slack
           #
           # @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
+          # @option options [boolean] :prevent_creation
+          #   Do not create a direct message or multi-person direct message. This is used to see if there is an existing dm or mpdm.
+          # @option options [boolean] :return_im
           #   Boolean, indicates you want the full IM channel definition in the response.
-          # @option options [Object] :users
+          # @option options [string] :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
@@ -238,7 +328,7 @@ module Slack
           #
           # @option options [channel] :channel
           #   ID of conversation to rename.
-          # @option options [Object] :name
+          # @option options [string] :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
@@ -256,13 +346,13 @@ module Slack
           #   Conversation ID to fetch thread from.
           # @option options [timestamp] :ts
           #   Unique identifier of either a thread's parent message or a message in the thread. ts must be the timestamp of an existing message with 0 or more replies. If there are no replies then just the single message referenced by ts will return - it is just an ordinary, unthreaded message.
-          # @option options [Object] :cursor
+          # @option options [string] :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] :inclusive
+          # @option options [boolean] :inclusive
           #   Include messages with latest or oldest timestamp in results only when either timestamp is specified.
           # @option options [timestamp] :latest
           #   End of time range of messages to include in results.
-          # @option options [Object] :limit
+          # @option options [number] :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.
@@ -286,7 +376,7 @@ module Slack
           #
           # @option options [channel] :channel
           #   Conversation to set the purpose of.
-          # @option options [Object] :purpose
+          # @option options [string] :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
@@ -302,7 +392,7 @@ module Slack
           #
           # @option options [channel] :channel
           #   Conversation to set the topic of.
-          # @option options [Object] :topic
+          # @option options [string] :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

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

@@ -9,9 +9,9 @@ module Slack
           #
           # Open a dialog with a user
           #
-          # @option options [Object] :dialog
+          # @option options [string] :dialog
           #   The dialog definition. This must be a JSON-encoded string.
-          # @option options [Object] :trigger_id
+          # @option options [string] :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

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

@@ -27,7 +27,7 @@ module Slack
           #
           # Retrieves a user's current Do Not Disturb status.
           #
-          # @option options [Object] :team_id
+          # @option options [string] :team_id
           #   Encoded team id where passed in user param belongs, required if org token is used. If no user param is passed, then a team which has access to the app should be passed.
           # @option options [user] :user
           #   User to fetch status for (defaults to current user).
@@ -41,21 +41,20 @@ module Slack
           #
           # Turns on Do Not Disturb mode for the current user, or changes its duration.
           #
-          # @option options [Object] :num_minutes
+          # @option options [string] :num_minutes
           #   Number of minutes, from now, to snooze until.
           # @see https://api.slack.com/methods/dnd.setSnooze
           # @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
 
           #
           # Retrieves the Do Not Disturb status for up to 50 users on a team.
           #
-          # @option options [Object] :users
+          # @option options [string] :users
           #   Comma-separated list of users to fetch Do Not Disturb status for.
-          # @option options [Object] :team_id
+          # @option options [string] :team_id
           #   Encoded team id where passed in users belong, required if org token is used.
           # @see https://api.slack.com/methods/dnd.teamInfo
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/dnd/dnd.teamInfo.json

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

@@ -40,9 +40,9 @@ module Slack
           #
           # @option options [file] :file
           #   Specify a file by providing its ID.
-          # @option options [Object] :cursor
+          # @option options [string] :cursor
           #   Parameter for pagination. File comments are paginated for a single file. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first "page" of the collection of comments. See pagination for more details.
-          # @option options [Object] :limit
+          # @option options [integer] :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.
           # @see https://api.slack.com/methods/files.info
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.info.json
@@ -62,15 +62,17 @@ module Slack
           #
           # @option options [channel] :channel
           #   Filter files appearing in a specific channel, indicated by its ID.
-          # @option options [Object] :show_files_hidden_by_limit
+          # @option options [string] :files
+          #   .
+          # @option options [boolean] :show_files_hidden_by_limit
           #   Show truncated file info for files hidden due to being too old, and the team who owns the file being over the file limit.
-          # @option options [Object] :team_id
+          # @option options [string] :team_id
           #   encoded team id to list files in, required if org token is used.
-          # @option options [Object] :ts_from
+          # @option options [string] :ts_from
           #   Filter files created after this timestamp (inclusive).
-          # @option options [Object] :ts_to
+          # @option options [string] :ts_to
           #   Filter files created before this timestamp (inclusive).
-          # @option options [Object] :types
+          # @option options [string] :types
           #   Filter files by type (see below). 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.
@@ -125,21 +127,21 @@ module Slack
           #
           # Uploads or creates a file.
           #
-          # @option options [Object] :channels
+          # @option options [string] :channels
           #   Comma-separated list of channel names or IDs where the file will be shared.
-          # @option options [Object] :content
+          # @option options [string] :content
           #   File contents via a POST variable. If omitting this parameter, you must provide a file.
           # @option options [file] :file
           #   File contents via multipart/form-data. If omitting this parameter, you must submit content.
-          # @option options [Object] :filename
+          # @option options [string] :filename
           #   Filename of file.
-          # @option options [Object] :filetype
+          # @option options [string] :filetype
           #   A file type identifier.
-          # @option options [Object] :initial_comment
+          # @option options [string] :initial_comment
           #   The message text introducing the file in specified channels.
-          # @option options [Object] :thread_ts
+          # @option options [string] :thread_ts
           #   Provide another message's ts value to upload this file as a reply. Never use a reply's ts value; use its parent instead.
-          # @option options [Object] :title
+          # @option options [string] :title
           #   Title of file.
           # @see https://api.slack.com/methods/files.upload
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.upload.json

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

@@ -11,7 +11,7 @@ module Slack
           #
           # @option options [file] :file
           #   File to delete a comment from.
-          # @option options [Object] :id
+          # @option options [string] :id
           #   The comment to delete.
           # @see https://api.slack.com/methods/files.comments.delete
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files.comments/files.comments.delete.json