slack-ruby-client 0.16.0 → 1.1.0

data/UPGRADING.md

@@ -1,6 +1,48 @@
 Upgrading Slack-Ruby-Client
 ===========================
 
+### Upgrading to >= 1.0.0
+
+#### Deprecated Methods
+
+Slack has deprecated all `channel` and `group` methods, which have been removed from the library.
+
+See [this announcement from Slack](https://api.slack.com/changelog/2020-01-deprecating-antecedents-to-the-conversations-api) for details.
+
+#### Error Handling
+
+As of 1.0.0 `Slack::Web::Api::Errors::ServerError` and its subclasses (introduced in 0.16.0) no longer extend `Slack::Web::Api::Errors::InternalError` or its parent `Slack::Web::Api::Errors::SlackError`. If you are rescuing `SlackError` or `InternalError` with the intention of including `ServerError` and its subclasses you should adjust your code to explicitly rescue `Slack::Web::Api::Errors::ServerError`.
+
+```ruby
+# Before
+begin
+  client.auth_test
+rescue Slack::Web::Api::Errors::SlackError
+  # Includes all server errors
+end
+
+# After
+begin
+  client.auth_test
+rescue Slack::Web::Api::Errors::SlackError, Slack::Web::Api::Errors::ServerError
+  # Need to rescue the server errors separately from SlackError
+end
+```
+
+Additionally the `initialize` method for `ParsingError`, `TimeoutError`, and `UnavailableError` have changed from `new(message, response)` to `new(response)`. The `message` is now built into the definition of these classes. If you are instantiating or raising these errors in your code (perhaps in tests) you will need to update your code.
+
+```ruby
+# Before
+error = Slack::Web::Api::Errors::TimeoutError.new('timeout_error', response)
+error.message
+# => 'timeout_error'
+
+# After
+error = Slack::Web::Api::Errors::TimeoutError.new(response)
+error.message
+# => 'timeout_error'
+```
+
 ### Upgrading to >= 0.16.0
 
 #### Removed Celluloid and Faye-Websocket Concurrency Support

data/bin/commands/admin_analytics.rb

@@ -6,8 +6,9 @@ command 'admin_analytics' do |g|
   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

data/bin/commands/admin_apps.rb

@@ -37,4 +37,15 @@ command 'admin_apps' do |g|
       puts JSON.dump($client.admin_apps_restrict(options))
     end
   end
+
+  g.desc 'Uninstall an app from one or many workspaces, or an entire enterprise organization.'
+  g.long_desc %( Uninstall an app from one or many workspaces, or an entire enterprise organization. )
+  g.command 'uninstall' do |c|
+    c.flag 'app_id', desc: 'The ID of the app to uninstall.'
+    c.flag 'enterprise_id', desc: 'The enterprise to completely uninstall the application from (across all workspaces). With an org-level token, this or team_ids is required.'
+    c.flag 'team_ids', desc: 'IDs of the teams to uninstall from (max 100). With an org-level token, this or enterprise_id is required.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.admin_apps_uninstall(options))
+    end
+  end
 end

data/bin/commands/admin_apps_requests.rb

@@ -3,10 +3,22 @@
 
 desc 'AdminAppsRequests methods.'
 command 'admin_apps_requests' do |g|
+  g.desc 'Cancel approval request for team'
+  g.long_desc %( Cancel approval request for team )
+  g.command 'cancel' do |c|
+    c.flag 'request_id', desc: 'The id of the request to cancel.'
+    c.flag 'enterprise_id', desc: 'The ID of the enterprise where this request belongs.'
+    c.flag 'team_id', desc: 'The ID of the workspace where this request belongs.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.admin_apps_requests_cancel(options))
+    end
+  end
+
   g.desc 'List app requests for a team/workspace.'
   g.long_desc %( List app requests for a team/workspace. )
   g.command 'list' do |c|
     c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
+    c.flag 'enterprise_id', desc: '.'
     c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 - 1000 both inclusive.'
     c.flag 'team_id', desc: '.'
     c.action do |_global_options, options, _args|

data/bin/commands/admin_auth_policy.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'AdminAuthPolicy methods.'
+command 'admin_auth_policy' do |g|
+  g.desc 'Assign entities to a particular authentication policy.'
+  g.long_desc %( Assign entities to a particular authentication policy. )
+  g.command 'assignEntities' do |c|
+    c.flag 'entity_ids', desc: 'Array of IDs to assign to the policy.'
+    c.flag 'entity_type', desc: 'The type of entity to assign to the policy. Currently, USER is supported.'
+    c.flag 'policy_name', desc: 'The name of the authentication policy to assign the entities to. Currently, email_password is the only policy that may be used with this method.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.admin_auth_policy_assignEntities(options))
+    end
+  end
+
+  g.desc 'Fetch all the entities assigned to a particular authentication policy by name.'
+  g.long_desc %( Fetch all the entities assigned to a particular authentication policy by name. )
+  g.command 'getEntities' do |c|
+    c.flag 'policy_name', desc: 'The name of the policy to fetch entities for. Currently, email_password is the only policy that may be used with this method.'
+    c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
+    c.flag 'entity_type', desc: 'The type of entity to assign to the policy. Currently, USER is supported.'
+    c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 and 1000, both inclusive.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.admin_auth_policy_getEntities(options))
+    end
+  end
+
+  g.desc 'Remove specified entities from a specified authentication policy.'
+  g.long_desc %( Remove specified entities from a specified authentication policy. )
+  g.command 'removeEntities' do |c|
+    c.flag 'entity_ids', desc: "Encoded IDs of the entities you'd like to remove from the policy."
+    c.flag 'entity_type', desc: 'The type of entity to assign to the policy. Currently, USER is supported.'
+    c.flag 'policy_name', desc: 'The name of the policy to remove entities from. Currently, email_password is the only policy that may be used with this method.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.admin_auth_policy_removeEntities(options))
+    end
+  end
+end

data/bin/commands/admin_conversations.rb

@@ -16,6 +16,7 @@ command 'admin_conversations' do |g|
   g.long_desc %( Convert a public channel to a private channel. )
   g.command 'convertToPrivate' do |c|
     c.flag 'channel_id', desc: 'The channel to convert to private.'
+    c.flag 'name', desc: 'Name of private channel to create. Only respected when converting an MPIM.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.admin_conversations_convertToPrivate(options))
     end
@@ -47,7 +48,7 @@ command 'admin_conversations' do |g|
   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.flag 'leaving_team_ids', desc: 'team IDs getting removed from the channel, optional if there are only two teams in the channel.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.admin_conversations_disconnectShared(options))
     end

data/bin/commands/admin_conversations_restrictAccess.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'Add and remove user groups from conversations.'
+desc 'AdminConversationsRestrictaccess methods.'
 command 'admin_conversations_restrictAccess' do |g|
   g.desc 'Add an allowlist of IDP groups for accessing a channel'
   g.long_desc %( Add an allowlist of IDP groups for accessing a channel )

data/bin/commands/admin_emoji.rb

@@ -16,8 +16,8 @@ command 'admin_emoji' do |g|
   g.desc 'Add an emoji alias.'
   g.long_desc %( Add an emoji alias. )
   g.command 'addAlias' do |c|
-    c.flag 'alias_for', desc: 'The alias of the emoji.'
-    c.flag 'name', desc: 'The name of the emoji to be aliased. Colons (:myemoji:) around the value are not required, although they may be included.'
+    c.flag 'alias_for', desc: 'Name of the emoji for which the alias is being made. Any wrapping whitespace or colons will be automatically trimmed.'
+    c.flag 'name', desc: 'The new alias for the specified emoji. Any wrapping whitespace or colons will be automatically trimmed.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.admin_emoji_addAlias(options))
     end

data/bin/commands/admin_teams.rb

@@ -6,7 +6,7 @@ command 'admin_teams' do |g|
   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."

data/bin/commands/admin_users.rb

@@ -23,6 +23,7 @@ command 'admin_users' do |g|
     c.flag 'email', desc: 'The email address of the person to invite.'
     c.flag 'team_id', desc: 'The ID (T1234) of the workspace.'
     c.flag 'custom_message', desc: 'An optional message to send to the user in the invite email.'
+    c.flag 'email_password_policy_enabled', desc: 'Allow invited user to sign in via email and password. Only available for Enterprise Grid teams via admin invite.'
     c.flag 'guest_expiration_ts', desc: 'Timestamp when guest account should be disabled. Only include this timestamp if you are inviting a guest user and you want their account to expire on a certain date.'
     c.flag 'is_restricted', desc: 'Is this user a multi-channel guest user? (default: false).'
     c.flag 'is_ultra_restricted', desc: 'Is this user a single channel guest user? (default: false).'

data/bin/commands/admin_users_session.rb

@@ -3,6 +3,24 @@
 
 desc 'AdminUsersSession methods.'
 command 'admin_users_session' do |g|
+  g.desc 'Clear user-specific session settings—the session duration and what happens when the client closes—for a list of users.'
+  g.long_desc %( Clear user-specific session settings—the session duration and what happens when the client closes—for a list of users. )
+  g.command 'clearSettings' do |c|
+    c.flag 'user_ids', desc: "The IDs of users you'd like to clear session settings for."
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.admin_users_session_clearSettings(options))
+    end
+  end
+
+  g.desc 'Get user-specific session settings—the session duration and what happens when the client closes—given a list of users.'
+  g.long_desc %( Get user-specific session settings—the session duration and what happens when the client closes—given a list of users. )
+  g.command 'getSettings' do |c|
+    c.flag 'user_ids', desc: "The IDs of users you'd like to fetch session settings for. Note: if a user does not have any active sessions, they will not be returned in the response."
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.admin_users_session_getSettings(options))
+    end
+  end
+
   g.desc 'Revoke a single session for a user. The user will be forced to login to Slack.'
   g.long_desc %( Revoke a single session for a user. The user will be forced to login to Slack. )
   g.command 'invalidate' do |c|
@@ -35,4 +53,26 @@ command 'admin_users_session' do |g|
       puts JSON.dump($client.admin_users_session_reset(options))
     end
   end
+
+  g.desc 'Enqueues an asynchronous job to wipe all valid sessions on all devices for a given list of users'
+  g.long_desc %( Enqueues an asynchronous job to wipe all valid sessions on all devices for a given list of users )
+  g.command 'resetBulk' do |c|
+    c.flag 'user_ids', desc: 'The ID of the user to wipe sessions for.'
+    c.flag 'mobile_only', desc: 'Only expire mobile sessions (default: false).'
+    c.flag 'web_only', desc: 'Only expire web sessions (default: false).'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.admin_users_session_resetBulk(options))
+    end
+  end
+
+  g.desc 'Configure the user-level session settings—the session duration and what happens when the client closes—for one or more users.'
+  g.long_desc %( Configure the user-level session settings—the session duration and what happens when the client closes—for one or more users. )
+  g.command 'setSettings' do |c|
+    c.flag 'user_ids', desc: 'The list of user IDs to apply the session settings for.'
+    c.flag 'desktop_app_browser_quit', desc: 'Terminate the session when the client—either the desktop app or a browser window—is closed.'
+    c.flag 'duration', desc: "The session duration, in seconds. The minimum value is 28800, which represents 8 hours; the max value is 315569520 or 10 years (that's a long Slack session)."
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.admin_users_session_setSettings(options))
+    end
+  end
 end

data/bin/commands/admin_users_unsupportedVersions.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'AdminUsersUnsupportedversions methods.'
+command 'admin_users_unsupportedVersions' do |g|
+  g.desc 'Ask Slackbot to send you an export listing all workspace members using unsupported software, presented as a zipped CSV file.'
+  g.long_desc %( Ask Slackbot to send you an export listing all workspace members using unsupported software, presented as a zipped CSV file. )
+  g.command 'export' do |c|
+    c.flag 'date_end_of_support', desc: 'Unix timestamp of the date of past or upcoming end of support cycles. If not provided will include all announced end of support cycles.'
+    c.flag 'date_sessions_started', desc: 'Unix timestamp of a date to start looking for user sessions. If not provided will start six months ago.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.admin_users_unsupportedVersions_export(options))
+    end
+  end
+end

data/bin/commands/apps_manifest.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'AppsManifest methods.'
+command 'apps_manifest' do |g|
+  g.desc 'Create an app from an app manifest.'
+  g.long_desc %( Create an app from an app manifest. )
+  g.command 'create' do |c|
+    c.flag 'manifest', desc: 'A JSON app manifest encoded as a string. This manifest must use a valid app manifest schema - read our guide to creating one.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.apps_manifest_create(options))
+    end
+  end
+
+  g.desc 'Permanently deletes an app created through app manifests'
+  g.long_desc %( Permanently deletes an app created through app manifests )
+  g.command 'delete' do |c|
+    c.flag 'app_id', desc: 'The ID of the app you want to delete.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.apps_manifest_delete(options))
+    end
+  end
+
+  g.desc 'Export an app manifest from an existing app'
+  g.long_desc %( Export an app manifest from an existing app )
+  g.command 'export' do |c|
+    c.flag 'app_id', desc: 'The ID of the app whose configuration you want to export as a manifest.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.apps_manifest_export(options))
+    end
+  end
+
+  g.desc 'Update an app from an app manifest'
+  g.long_desc %( Update an app from an app manifest )
+  g.command 'update' do |c|
+    c.flag 'app_id', desc: 'The ID of the app whose configuration you want to update.'
+    c.flag 'manifest', desc: 'A JSON app manifest encoded as a string. This manifest must use a valid app manifest schema - read our guide to creating one. As this method entirely replaces any previous configuration, manifest must contain both unmodified and modified fields.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.apps_manifest_update(options))
+    end
+  end
+
+  g.desc 'Validate an app manifest'
+  g.long_desc %( Validate an app manifest )
+  g.command 'validate' do |c|
+    c.flag 'manifest', desc: 'The manifest to be validated. Will be validated against the app manifest schema - read our guide.'
+    c.flag 'app_id', desc: 'The ID of the app whose configuration you want to validate.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.apps_manifest_validate(options))
+    end
+  end
+end

data/bin/commands/bookmarks.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'Bookmarks methods.'
+command 'bookmarks' do |g|
+  g.desc 'Add bookmark to a channel.'
+  g.long_desc %( Add bookmark to a channel. )
+  g.command 'add' do |c|
+    c.flag 'channel_id', desc: 'Channel to add bookmark in.'
+    c.flag 'title', desc: 'Title for the bookmark.'
+    c.flag 'type', desc: 'Type of the bookmark i.e link.'
+    c.flag 'emoji', desc: 'Emoji tag to apply to the link.'
+    c.flag 'entity_id', desc: 'ID of the entity being bookmarked. Only applies to message and file types.'
+    c.flag 'link', desc: 'Link to bookmark.'
+    c.flag 'parent_id', desc: "Id of this bookmark's parent."
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.bookmarks_add(options))
+    end
+  end
+
+  g.desc 'Edit bookmark.'
+  g.long_desc %( Edit bookmark. )
+  g.command 'edit' do |c|
+    c.flag 'bookmark_id', desc: 'Bookmark to update.'
+    c.flag 'channel_id', desc: 'Channel to update bookmark in.'
+    c.flag 'emoji', desc: 'Emoji tag to apply to the link.'
+    c.flag 'link', desc: 'Link to bookmark.'
+    c.flag 'title', desc: 'Title for the bookmark.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.bookmarks_edit(options))
+    end
+  end
+
+  g.desc 'List bookmark for the channel.'
+  g.long_desc %( List bookmark for the channel. )
+  g.command 'list' do |c|
+    c.flag 'channel_id', desc: 'Channel to list bookmarks in.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.bookmarks_list(options))
+    end
+  end
+
+  g.desc 'Remove bookmark from the channel.'
+  g.long_desc %( Remove bookmark from the channel. )
+  g.command 'remove' do |c|
+    c.flag 'bookmark_id', desc: 'Bookmark to remove.'
+    c.flag 'channel_id', desc: 'Channel to remove bookmark.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.bookmarks_remove(options))
+    end
+  end
+end

data/bin/commands/channels.rb

@@ -3,26 +3,6 @@
 
 desc "Get info on your team's Slack channels, create or archive channels, invite users, set the topic and purpose, and mark a channel as read."
 command 'channels' do |g|
-  g.desc 'Archives a channel.'
-  g.long_desc %( Archives a channel. )
-  g.command 'archive' do |c|
-    c.flag 'channel', desc: 'Channel to archive.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_archive(options))
-    end
-  end
-
-  g.desc 'Creates a channel.'
-  g.long_desc %( Creates a channel. )
-  g.command 'create' do |c|
-    c.flag 'name', desc: 'Name of channel to create.'
-    c.flag 'team_id', desc: 'encoded team id to create the channel in, required if org token is used.'
-    c.flag 'validate', desc: 'Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_create(options))
-    end
-  end
-
   g.desc 'Delete a channel (undocumented)'
   g.long_desc %( Delete a channel )
   g.command 'delete' do |c|
@@ -32,19 +12,6 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Fetches history of messages and events from a channel.'
-  g.long_desc %( Fetches history of messages and events from a channel. )
-  g.command 'history' do |c|
-    c.flag 'channel', desc: 'Channel to fetch history for.'
-    c.flag 'inclusive', desc: 'Include messages with latest or oldest timestamp in results.'
-    c.flag 'latest', desc: 'End of time range of messages to include in results.'
-    c.flag 'oldest', desc: 'Start of time range of messages to include in results.'
-    c.flag 'unreads', desc: 'Include unread_count_display in the output?.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_history(options))
-    end
-  end
-
   g.desc 'This method returns the ID of a team channel.'
   g.long_desc %( This method returns the ID of a team channel. )
   g.command 'id' do |c|
@@ -53,128 +20,4 @@ command 'channels' do |g|
       puts JSON.dump($client.channels_id(options))
     end
   end
-
-  g.desc 'Gets information about a channel.'
-  g.long_desc %( Gets information about a channel. )
-  g.command 'info' do |c|
-    c.flag 'channel', desc: 'Channel to get info on.'
-    c.flag 'include_locale', desc: 'Set this to true to receive the locale for this channel. Defaults to false.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_info(options))
-    end
-  end
-
-  g.desc 'Invites a user to a channel.'
-  g.long_desc %( Invites a user to a channel. )
-  g.command 'invite' do |c|
-    c.flag 'channel', desc: 'Channel to invite user to.'
-    c.flag 'user', desc: 'User to invite to channel.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_invite(options))
-    end
-  end
-
-  g.desc 'Joins a channel, creating it if needed.'
-  g.long_desc %( Joins a channel, creating it if needed. )
-  g.command 'join' do |c|
-    c.flag 'name', desc: 'Name of channel to join.'
-    c.flag 'team_id', desc: 'encoded team id to list channels in, required if org token is used.'
-    c.flag 'validate', desc: 'Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_join(options))
-    end
-  end
-
-  g.desc 'Removes a user from a channel.'
-  g.long_desc %( Removes a user from a channel. )
-  g.command 'kick' do |c|
-    c.flag 'channel', desc: 'Channel to remove user from.'
-    c.flag 'user', desc: 'User to remove from channel.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_kick(options))
-    end
-  end
-
-  g.desc 'Leaves a channel.'
-  g.long_desc %( Leaves a channel. )
-  g.command 'leave' do |c|
-    c.flag 'channel', desc: 'Channel to leave.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_leave(options))
-    end
-  end
-
-  g.desc 'Lists all channels in a Slack team.'
-  g.long_desc %( Lists all channels in a Slack team. )
-  g.command 'list' do |c|
-    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: 'Exclude archived channels from the list.'
-    c.flag 'exclude_members', desc: 'Exclude the members collection from each channel.'
-    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 users list hasn't been reached."
-    c.flag 'team_id', desc: 'encoded team id to list channels in, required if org token is used.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_list(options))
-    end
-  end
-
-  g.desc 'Sets the read cursor in a channel.'
-  g.long_desc %( Sets the read cursor in a channel. )
-  g.command 'mark' do |c|
-    c.flag 'channel', desc: 'Channel or conversation to set the read cursor for.'
-    c.flag 'ts', desc: 'Unique identifier of message you want marked as most recently seen in this conversation.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_mark(options))
-    end
-  end
-
-  g.desc 'Renames a channel.'
-  g.long_desc %( Renames a channel. )
-  g.command 'rename' do |c|
-    c.flag 'channel', desc: 'Channel to rename.'
-    c.flag 'name', desc: 'New name for channel.'
-    c.flag 'validate', desc: 'Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_rename(options))
-    end
-  end
-
-  g.desc 'Retrieve a thread of messages posted to a channel'
-  g.long_desc %( Retrieve a thread of messages posted to a channel )
-  g.command 'replies' do |c|
-    c.flag 'channel', desc: 'Channel to fetch thread from.'
-    c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_replies(options))
-    end
-  end
-
-  g.desc 'Sets the purpose for a channel.'
-  g.long_desc %( Sets the purpose for a channel. )
-  g.command 'setPurpose' do |c|
-    c.flag 'channel', desc: 'Channel to set the purpose of.'
-    c.flag 'purpose', desc: 'The new purpose.'
-    c.flag 'name_tagging', desc: 'if it is true, treat this like a message and not an unescaped thing.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_setPurpose(options))
-    end
-  end
-
-  g.desc 'Sets the topic for a channel.'
-  g.long_desc %( Sets the topic for a channel. )
-  g.command 'setTopic' do |c|
-    c.flag 'channel', desc: 'Channel to set the topic of.'
-    c.flag 'topic', desc: 'The new topic.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_setTopic(options))
-    end
-  end
-
-  g.desc 'Unarchives a channel.'
-  g.long_desc %( Unarchives a channel. )
-  g.command 'unarchive' do |c|
-    c.flag 'channel', desc: 'Channel to unarchive.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_unarchive(options))
-    end
-  end
 end

data/bin/commands/chat.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'Post chat messages to Slack.'
+desc 'Chat methods.'
 command 'chat' do |g|
   g.desc 'Execute a slash command in a public channel (undocumented)'
   g.long_desc %( Execute a slash command in a public channel )
@@ -59,11 +59,11 @@ command 'chat' do |g|
   g.desc 'Sends an ephemeral message to a user in a channel.'
   g.long_desc %( Sends an ephemeral message to a user in a channel. )
   g.command 'postEphemeral' do |c|
-    c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
     c.flag 'channel', desc: 'Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name.'
     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 'user', desc: 'id of the user who will receive the ephemeral message. The user should be in the channel specified by the channel argument.'
     c.flag 'as_user', desc: '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.'
+    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. 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.'
@@ -80,12 +80,12 @@ command 'chat' do |g|
   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 '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 'text', desc: 'The formatted text of the message to be published. If blocks are included, this will become the fallback text used in notifications.'
+    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 '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.'
@@ -93,7 +93,7 @@ command 'chat' do |g|
     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
@@ -122,10 +122,13 @@ command 'chat' do |g|
   g.desc 'Provide custom unfurl behavior for user-posted URLs'
   g.long_desc %( Provide custom unfurl behavior for user-posted URLs )
   g.command 'unfurl' do |c|
-    c.flag 'channel', desc: 'Channel ID of the message.'
+    c.flag 'channel', desc: 'Channel ID of the message. Both channel and ts must be provided together, or unfurl_id and source must be provided together.'
     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 'source', desc: '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.'
+    c.flag 'unfurl_id', desc: 'The ID of the link to unfurl. Both unfurl_id and source must be provided together, or channel and ts must be provided together.'
+    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|
@@ -141,8 +144,10 @@ command 'chat' do |g|
     c.flag 'as_user', desc: 'Pass true to update the message as the authed user. Bot users in this context are considered authed users.'
     c.flag 'attachments', desc: "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."
     c.flag 'blocks', desc: "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."
+    c.flag 'file_ids', desc: 'Array of new file ids that will be sent with this message.'
     c.flag 'link_names', desc: '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.'
     c.flag 'parse', desc: '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.'
+    c.flag 'reply_broadcast', desc: 'Broadcast an existing thread reply to make it visible to everyone in the channel or conversation.'
     c.flag 'text', desc: "New text for the message, using the default formatting rules. It's not required when presenting blocks or attachments."
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.chat_update(options))