slack-ruby-client 0.15.0 → 1.0.0

data/bin/commands/channels.rb

@@ -1,27 +1,8 @@
 # frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'Channels methods.'
+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 '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|
@@ -31,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|
@@ -52,126 +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 '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.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 to set reading cursor in.'
-    c.flag 'ts', desc: 'Timestamp of the most recently seen message.'
-    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

@@ -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. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below. This argument may not be used with newer bot tokens.'
-    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. This argument may not be used with newer bot tokens.'
+    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.'
@@ -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))

data/bin/commands/chat_scheduledMessages.rb

@@ -11,6 +11,7 @@ command 'chat_scheduledMessages' do |g|
     c.flag 'latest', desc: 'A UNIX timestamp of the latest value in the time range.'
     c.flag 'limit', desc: 'Maximum number of original entries to return.'
     c.flag 'oldest', desc: 'A UNIX timestamp of the oldest value in the time range.'
+    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.chat_scheduledMessages_list(options))
     end

data/bin/commands/conversations.rb

@@ -3,6 +3,30 @@
 
 desc 'Conversations methods.'
 command 'conversations' do |g|
+  g.desc 'Accepts an invitation to a Slack Connect channel.'
+  g.long_desc %( Accepts an invitation to a Slack Connect channel. )
+  g.command 'acceptSharedInvite' do |c|
+    c.flag 'channel_name', desc: 'Name of the channel. If the channel does not exist already in your workspace, this name is the one that the channel will take.'
+    c.flag 'channel_id', desc: "ID of the channel that you'd like to accept. Must provide either invite_id or channel_id."
+    c.flag 'free_trial_accepted', desc: "Whether you'd like to use your workspace's free trial to begin using Slack Connect."
+    c.flag 'invite_id', desc: 'See the shared_channel_invite_received event payload for more details on how to retrieve the ID of the invitation.'
+    c.flag 'is_private', desc: 'Whether the channel should be private.'
+    c.flag 'team_id', desc: '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.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_acceptSharedInvite(options))
+    end
+  end
+
+  g.desc 'Approves an invitation to a Slack Connect channel'
+  g.long_desc %( Approves an invitation to a Slack Connect channel )
+  g.command 'approveSharedInvite' do |c|
+    c.flag 'invite_id', desc: 'ID of the shared channel invite to approve.'
+    c.flag 'target_team', desc: 'The team or enterprise id of the other party involved in the invitation you are approving.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_approveSharedInvite(options))
+    end
+  end
+
   g.desc 'Archives a conversation.'
   g.long_desc %( Archives a conversation. )
   g.command 'archive' do |c|
@@ -26,18 +50,29 @@ command 'conversations' do |g|
   g.command 'create' do |c|
     c.flag 'name', desc: 'Name of the public or private channel to create.'
     c.flag 'is_private', desc: 'Create a private channel instead of a public one.'
+    c.flag 'team_id', desc: 'encoded team id to create the channel in, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.conversations_create(options))
     end
   end
 
+  g.desc 'Declines a Slack Connect channel invite.'
+  g.long_desc %( Declines a Slack Connect channel invite. )
+  g.command 'declineSharedInvite' do |c|
+    c.flag 'invite_id', desc: '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.'
+    c.flag 'target_team', desc: 'The team or enterprise id of the other party involved in the invitation you are declining.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_declineSharedInvite(options))
+    end
+  end
+
   g.desc "Fetches a conversation's history of messages and events."
   g.long_desc %( Fetches a conversation's history of messages and events. )
   g.command 'history' do |c|
     c.flag 'channel', desc: 'Conversation ID to fetch history for.'
     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.'
+    c.flag 'latest', desc: 'End of time range of messages to include in results. Default is the current time.'
     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 'oldest', desc: 'Start of time range of messages to include in results.'
     c.action do |_global_options, options, _args|
@@ -66,6 +101,18 @@ command 'conversations' do |g|
     end
   end
 
+  g.desc 'Sends an invitation to a Slack Connect channel'
+  g.long_desc %( Sends an invitation to a Slack Connect channel )
+  g.command 'inviteShared' do |c|
+    c.flag 'channel', desc: "ID of the channel on your team that you'd like to share."
+    c.flag 'emails', desc: 'Optional email to receive this invite. Either emails or user_ids must be provided.'
+    c.flag 'external_limited', desc: 'Optional boolean on whether invite is to a external limited member. Defaults to true.'
+    c.flag 'user_ids', desc: 'Optional user_id to receive this invite. Either emails or user_ids must be provided.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_inviteShared(options))
+    end
+  end
+
   g.desc 'Joins an existing conversation.'
   g.long_desc %( Joins an existing conversation. )
   g.command 'join' do |c|
@@ -100,12 +147,33 @@ command 'conversations' do |g|
     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 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))
     end
   end
 
+  g.desc 'Lists shared channel invites that have been generated or received but have not been approved by all parties'
+  g.long_desc %( Lists shared channel invites that have been generated or received but have not been approved by all parties )
+  g.command 'listConnectInvites' do |c|
+    c.flag 'cursor', desc: 'Set to next_cursor returned by previous call to list items in subsequent page.'
+    c.flag 'team_id', desc: 'Encoded team id for the workspace to retrieve invites for, required if org token is used.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.conversations_listConnectInvites(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.conversations_mark(options))
+    end
+  end
+
   g.desc 'Retrieve members of a conversation.'
   g.long_desc %( Retrieve members of a conversation. )
   g.command 'members' do |c|
@@ -121,6 +189,7 @@ command 'conversations' do |g|
   g.long_desc %( Opens or resumes a direct message or multi-person direct message. )
   g.command 'open' do |c|
     c.flag 'channel', desc: "Resume a conversation by supplying an im or mpim's ID. Or provide the users field instead."
+    c.flag 'prevent_creation', desc: 'Do not create a direct message or multi-person direct message. This is used to see if there is an existing dm or mpdm.'
     c.flag 'return_im', desc: 'Boolean, indicates you want the full IM channel definition in the response.'
     c.flag 'users', desc: '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.'
     c.action do |_global_options, options, _args|
@@ -142,7 +211,7 @@ command 'conversations' do |g|
   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."
+    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.'

data/bin/commands/dnd.rb

@@ -22,6 +22,7 @@ command 'dnd' do |g|
   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 @@ command 'dnd' do |g|
   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

data/bin/commands/files.rb

@@ -23,8 +23,8 @@ command 'files' do |g|
     end
   end
 
-  g.desc 'Gets information about a team file.'
-  g.long_desc %( Gets information about a team file. )
+  g.desc 'Gets information about a file.'
+  g.long_desc %( Gets information about a file. )
   g.command 'info' do |c|
     c.flag 'file', desc: 'Specify a file by providing its ID.'
     c.flag 'cursor', desc: "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."
@@ -34,11 +34,13 @@ command 'files' do |g|
     end
   end
 
-  g.desc 'Lists & filters team files.'
-  g.long_desc %( Lists & filters team files. )
+  g.desc 'List for a team, in a channel, or from a user with applied filters.'
+  g.long_desc %( List for a team, in a channel, or from a user with applied filters. )
   g.command 'list' do |c|
     c.flag 'channel', desc: 'Filter files appearing in a specific channel, indicated by its ID.'
+    c.flag 'files', desc: '.'
     c.flag 'show_files_hidden_by_limit', desc: 'Show truncated file info for files hidden due to being too old, and the team who owns the file being over the file limit.'
+    c.flag 'team_id', desc: 'encoded team id to list files in, required if org token is used.'
     c.flag 'ts_from', desc: 'Filter files created after this timestamp (inclusive).'
     c.flag 'ts_to', desc: 'Filter files created before this timestamp (inclusive).'
     c.flag 'types', desc: '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.'

data/bin/commands/files_remote.rb

@@ -54,8 +54,8 @@ command 'files_remote' do |g|
   g.long_desc %( Share a remote file into a channel. )
   g.command 'share' do |c|
     c.flag 'channels', desc: 'Comma-separated list of channel IDs where the file will be shared.'
-    c.flag 'external_id', desc: 'Creator defined GUID for the file.'
-    c.flag 'file', desc: 'Specify a file by providing its ID.'
+    c.flag 'external_id', desc: 'The globally unique identifier (GUID) for the file, as set by the app registering the file with Slack.  Either this field or file or both are required.'
+    c.flag 'file', desc: 'Specify a file registered with Slack by providing its ID. Either this field or external_id or both are required.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.files_remote_share(options))
     end

data/bin/commands/groups.rb

@@ -1,49 +1,8 @@
 # frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'Groups methods.'
+desc "Get info on your team's private channels."
 command 'groups' do |g|
-  g.desc 'Archives a private channel.'
-  g.long_desc %( Archives a private channel. )
-  g.command 'archive' do |c|
-    c.flag 'channel', desc: 'Private channel to archive.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_archive(options))
-    end
-  end
-
-  g.desc 'Creates a private channel.'
-  g.long_desc %( Creates a private channel. )
-  g.command 'create' do |c|
-    c.flag 'name', desc: 'Name of private channel to create.'
-    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.groups_create(options))
-    end
-  end
-
-  g.desc 'Clones and archives a private channel.'
-  g.long_desc %( Clones and archives a private channel. )
-  g.command 'createChild' do |c|
-    c.flag 'channel', desc: 'Private channel to clone and archive.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_createChild(options))
-    end
-  end
-
-  g.desc 'Fetches history of messages and events from a private channel.'
-  g.long_desc %( Fetches history of messages and events from a private channel. )
-  g.command 'history' do |c|
-    c.flag 'channel', desc: 'Private 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.groups_history(options))
-    end
-  end
-
   g.desc 'This method returns the ID of a group.'
   g.long_desc %( This method returns the ID of a group. )
   g.command 'id' do |c|
@@ -52,124 +11,4 @@ command 'groups' do |g|
       puts JSON.dump($client.groups_id(options))
     end
   end
-
-  g.desc 'Gets information about a private channel.'
-  g.long_desc %( Gets information about a private channel. )
-  g.command 'info' do |c|
-    c.flag 'channel', desc: 'Private channel to get info on.'
-    c.flag 'include_locale', desc: 'Set this to true to receive the locale for this group. Defaults to false.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_info(options))
-    end
-  end
-
-  g.desc 'Invites a user to a private channel.'
-  g.long_desc %( Invites a user to a private channel. )
-  g.command 'invite' do |c|
-    c.flag 'channel', desc: 'Private channel to invite user to.'
-    c.flag 'user', desc: 'User to invite.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_invite(options))
-    end
-  end
-
-  g.desc 'Removes a user from a private channel.'
-  g.long_desc %( Removes a user from a private channel. )
-  g.command 'kick' do |c|
-    c.flag 'channel', desc: 'Private channel to remove user from.'
-    c.flag 'user', desc: 'User to remove from private channel.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_kick(options))
-    end
-  end
-
-  g.desc 'Leaves a private channel.'
-  g.long_desc %( Leaves a private channel. )
-  g.command 'leave' do |c|
-    c.flag 'channel', desc: 'Private channel to leave.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_leave(options))
-    end
-  end
-
-  g.desc 'Lists private channels that the calling user has access to.'
-  g.long_desc %( Lists private channels that the calling user has access to. )
-  g.command 'list' do |c|
-    c.flag 'cursor', desc: "Parameter for pagination. 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. See pagination for more details."
-    c.flag 'exclude_archived', desc: "Don't return archived private channels."
-    c.flag 'exclude_members', desc: 'Exclude the members from each group.'
-    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."
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_list(options))
-    end
-  end
-
-  g.desc 'Sets the read cursor in a private channel.'
-  g.long_desc %( Sets the read cursor in a private channel. )
-  g.command 'mark' do |c|
-    c.flag 'channel', desc: 'Private channel to set reading cursor in.'
-    c.flag 'ts', desc: 'Timestamp of the most recently seen message.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_mark(options))
-    end
-  end
-
-  g.desc 'Opens a private channel.'
-  g.long_desc %( Opens a private channel. )
-  g.command 'open' do |c|
-    c.flag 'channel', desc: 'Private channel to open.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_open(options))
-    end
-  end
-
-  g.desc 'Renames a private channel.'
-  g.long_desc %( Renames a private channel. )
-  g.command 'rename' do |c|
-    c.flag 'channel', desc: 'Private channel to rename.'
-    c.flag 'name', desc: 'New name for private 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.groups_rename(options))
-    end
-  end
-
-  g.desc 'Retrieve a thread of messages posted to a private channel'
-  g.long_desc %( Retrieve a thread of messages posted to a private channel )
-  g.command 'replies' do |c|
-    c.flag 'channel', desc: 'Private 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.groups_replies(options))
-    end
-  end
-
-  g.desc 'Sets the purpose for a private channel.'
-  g.long_desc %( Sets the purpose for a private channel. )
-  g.command 'setPurpose' do |c|
-    c.flag 'channel', desc: 'Private channel to set the purpose of.'
-    c.flag 'purpose', desc: 'The new purpose.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_setPurpose(options))
-    end
-  end
-
-  g.desc 'Sets the topic for a private channel.'
-  g.long_desc %( Sets the topic for a private channel. )
-  g.command 'setTopic' do |c|
-    c.flag 'channel', desc: 'Private channel to set the topic of.'
-    c.flag 'topic', desc: 'The new topic.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_setTopic(options))
-    end
-  end
-
-  g.desc 'Unarchives a private channel.'
-  g.long_desc %( Unarchives a private channel. )
-  g.command 'unarchive' do |c|
-    c.flag 'channel', desc: 'Private channel to unarchive.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_unarchive(options))
-    end
-  end
 end