Updated from latest slack-api-ref.

Author: dblock

CHANGELOG.md

@@ -1,5 +1,6 @@
 ### 0.16.1 (Next)
 
+* [#368](https://github.com/slack-ruby/slack-ruby-client/pull/368): Removed `admin_conversations_whitelist` and `admin_conversations_disconnectShared` - [@dblock](https://github.com/dblock).
 * [#359](https://github.com/slack-ruby/slack-ruby-client/pull/359): Handle non-JSON 500 errors - [@agrobbin](https://github.com/agrobbin).
 * [#360](https://github.com/slack-ruby/slack-ruby-client/pull/360): Remove faye-websocket from the concurrency detection error message - [@dblock](https://github.com/dblock).
 * Your contribution here.

bin/commands.rb

@@ -10,7 +10,6 @@
 require 'commands/admin_conversations'
 require 'commands/admin_conversations_ekm'
 require 'commands/admin_conversations_restrictAccess'
-require 'commands/admin_conversations_whitelist'
 require 'commands/admin_emoji'
 require 'commands/admin_inviteRequests'
 require 'commands/admin_inviteRequests_approved'

bin/commands/admin_analytics.rb

@@ -6,8 +6,9 @@
   g.desc 'Retrieve analytics data for a given date, presented as a compressed JSON file'
   g.long_desc %( Retrieve analytics data for a given date, presented as a compressed JSON file )
   g.command 'getFile' do |c|
-    c.flag 'type', desc: 'The type of analytics to retrieve. The options are currently limited to member.'
+    c.flag 'type', desc: 'The type of analytics to retrieve. The options are currently limited to member (for grid member analytics) and public_channel (for public channel analytics).'
     c.flag 'date', desc: 'Date to retrieve the analytics data for, expressed as YYYY-MM-DD in UTC.'
+    c.flag 'metadata_only', desc: 'Retrieve metadata for the type of analytics indicated. Can be used only with type set to public_channel analytics. See detail below. Omit the date parameter when using this argument.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.admin_analytics_getFile(options))
     end

bin/commands/admin_conversations.rb

@@ -43,16 +43,6 @@
     end
   end
 
-  g.desc 'Disconnect a connected channel from one or more workspaces.'
-  g.long_desc %( Disconnect a connected channel from one or more workspaces. )
-  g.command 'disconnectShared' do |c|
-    c.flag 'channel_id', desc: 'The channel to be disconnected from some workspaces.'
-    c.flag 'leaving_team_ids', desc: 'The team to be removed from the channel. Currently only a single team id can be specified.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.admin_conversations_disconnectShared(options))
-    end
-  end
-
   g.desc 'Get conversation preferences for a public or private channel.'
   g.long_desc %( Get conversation preferences for a public or private channel. )
   g.command 'getConversationPrefs' do |c|

bin/commands/admin_teams.rb

@@ -6,7 +6,7 @@
   g.desc 'Create an Enterprise team.'
   g.long_desc %( Create an Enterprise team. )
   g.command 'create' do |c|
-    c.flag 'team_domain', desc: 'Team domain (for example, slacksoftballteam).'
+    c.flag 'team_domain', desc: 'Team domain (for example, slacksoftballteam). Domains are limited to 21 characters.'
     c.flag 'team_name', desc: 'Team name (for example, Slack Softball Team).'
     c.flag 'team_description', desc: 'Description for the team.'
     c.flag 'team_discoverability', desc: "Who can join the team. A team's discoverability can be open, closed, invite_only, or unlisted."

bin/commands/chat.rb

@@ -80,20 +80,21 @@
   g.long_desc %( Sends a message to a channel. )
   g.command 'postMessage' do |c|
     c.flag 'channel', desc: 'Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name. See below for more details.'
-    c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
-    c.flag 'as_user', desc: 'Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below. This argument may not be used with newer bot tokens.'
+    c.flag 'as_user', desc: 'Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below.'
     c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
     c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
-    c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url. See authorship below. Use with bot tokens requires chat:write.customize.'
-    c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message. See authorship below. Use with bot tokens requires chat:write.customize.'
+    c.flag 'draft_id', desc: 'The id of the draft associated with the message.'
+    c.flag 'icon_emoji', desc: '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.'
+    c.flag 'icon_url', desc: '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.'
     c.flag 'link_names', desc: 'Find and link channel names and usernames.'
     c.flag 'mrkdwn', desc: 'Disable Slack markup parsing by setting to false. Enabled by default.'
     c.flag 'parse', desc: 'Change how messages are treated. Defaults to none. See below.'
     c.flag 'reply_broadcast', desc: 'Used in conjunction with thread_ts and indicates whether reply should be made visible to everyone in the channel or conversation. Defaults to false.'
+    c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
     c.flag 'thread_ts', desc: "Provide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead."
     c.flag 'unfurl_links', desc: 'Pass true to enable unfurling of primarily text-based content.'
     c.flag 'unfurl_media', desc: 'Pass false to disable unfurling of media content.'
-    c.flag 'username', desc: "Set your bot's user name. See authorship below. Use with bot tokens requires chat:write.customize."
+    c.flag 'username', desc: "Set your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below."
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.chat_postMessage(options))
     end
@@ -125,7 +126,8 @@
     c.flag 'channel', desc: 'Channel ID of the message.'
     c.flag 'ts', desc: 'Timestamp of the message to add unfurl behavior to.'
     c.flag 'unfurls', desc: 'URL-encoded JSON map with keys set to URLs featured in the the message, pointing to their unfurl blocks or message attachments.'
-    c.flag 'user_auth_message', desc: 'Provide a simply-formatted string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior.'
+    c.flag 'user_auth_blocks', desc: '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.'
+    c.flag 'user_auth_message', desc: '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.'
     c.flag 'user_auth_required', desc: 'Set to true or 1 to indicate the user must install your Slack app to trigger unfurls for this domain.'
     c.flag 'user_auth_url', desc: 'Send users to this custom URL where they will complete authentication in your app to fully trigger unfurling. Value should be properly URL-encoded.'
     c.action do |_global_options, options, _args|

bin/commands/conversations.rb

@@ -101,7 +101,7 @@
     c.flag 'cursor', desc: "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."
     c.flag 'exclude_archived', desc: 'Set to true to exclude archived channels from the list.'
     c.flag 'limit', desc: "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."
-    c.flag 'team_id', desc: 'encoded team id to list channels in, required if org token is used.'
+    c.flag 'team_id', desc: 'encoded team id to list channels in, required if token belongs to org-wide app.'
     c.flag 'types', desc: 'Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.conversations_list(options))
@@ -154,7 +154,7 @@
   g.long_desc %( Retrieve a thread of messages posted to a conversation )
   g.command 'replies' do |c|
     c.flag 'channel', desc: 'Conversation ID to fetch thread from.'
-    c.flag 'ts', desc: "Unique identifier of a thread's parent message. 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."
+    c.flag 'ts', desc: "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."
     c.flag 'cursor', desc: "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."
     c.flag 'inclusive', desc: 'Include messages with latest or oldest timestamp in results only when either timestamp is specified.'
     c.flag 'latest', desc: 'End of time range of messages to include in results.'

bin/commands/dnd.rb

@@ -22,6 +22,7 @@
   g.desc "Retrieves a user's current Do Not Disturb status."
   g.long_desc %( Retrieves a user's current Do Not Disturb status. )
   g.command 'info' do |c|
+    c.flag 'team_id', desc: '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.'
     c.flag 'user', desc: 'User to fetch status for (defaults to current user).'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.dnd_info(options))
@@ -41,6 +42,7 @@
   g.long_desc %( Retrieves the Do Not Disturb status for up to 50 users on a team. )
   g.command 'teamInfo' do |c|
     c.flag 'users', desc: 'Comma-separated list of users to fetch Do Not Disturb status for.'
+    c.flag 'team_id', desc: 'Encoded team id where passed in users belong, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.dnd_teamInfo(options))
     end

lib/slack/web/api/endpoints.rb

@@ -10,7 +10,6 @@
 require_relative 'endpoints/admin_conversations'
 require_relative 'endpoints/admin_conversations_ekm'
 require_relative 'endpoints/admin_conversations_restrictAccess'
-require_relative 'endpoints/admin_conversations_whitelist'
 require_relative 'endpoints/admin_emoji'
 require_relative 'endpoints/admin_inviteRequests'
 require_relative 'endpoints/admin_inviteRequests_approved'
@@ -86,7 +85,6 @@ module Endpoints
         include AdminConversations
         include AdminConversationsEkm
         include AdminConversationsRestrictaccess
-        include AdminConversationsWhitelist
         include AdminEmoji
         include AdminInviterequests
         include AdminInviterequestsApproved

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

@@ -10,9 +10,11 @@ module AdminAnalytics
           # Retrieve analytics data for a given date, presented as a compressed JSON file
           #
           # @option options [Object] :type
-          #   The type of analytics to retrieve. The options are currently limited to member.
+          #   The type of analytics to retrieve. The options are currently limited to member (for grid member analytics) and public_channel (for public channel analytics).
           # @option options [Object] :date
           #   Date to retrieve the analytics data for, expressed as YYYY-MM-DD in UTC.
+          # @option options [Object] :metadata_only
+          #   Retrieve metadata for the type of analytics indicated. Can be used only with type set to public_channel analytics. See detail below. Omit the date parameter when using this argument.
           # @see https://api.slack.com/methods/admin.analytics.getFile
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.analytics/admin.analytics.getFile.json
           def admin_analytics_getFile(options = {})