slack-ruby-client 0.14.5 → 0.17.0

data/bin/commands/apps_event_authorizations.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'AppsEventAuthorizations methods.'
+command 'apps_event_authorizations' do |g|
+  g.desc 'Get a list of authorizations for the given event context. Each authorization represents an app installation that the event is visible to.'
+  g.long_desc %( Get a list of authorizations for the given event context. Each authorization represents an app installation that the event is visible to. )
+  g.command 'list' do |c|
+    c.flag 'event_context', desc: '.'
+    c.flag 'cursor', desc: '.'
+    c.flag 'limit', desc: '.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.apps_event_authorizations_list(options))
+    end
+  end
+end

data/bin/commands/auth_teams.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'AuthTeams methods.'
+command 'auth_teams' do |g|
+  g.desc 'List the workspaces a token can access.'
+  g.long_desc %( List the workspaces a token can access. )
+  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 'include_icon', desc: 'Whether to return icon paths for each workspace. An icon path represents a URI pointing to the image signifying the workspace.'
+    c.flag 'limit', desc: 'The maximum number of workspaces to return. Must be a positive integer no larger than 1000.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.auth_teams_list(options))
+    end
+  end
+end

data/bin/commands/bots.rb

@@ -7,6 +7,7 @@ command 'bots' do |g|
   g.long_desc %( Gets information about a bot user. )
   g.command 'info' do |c|
     c.flag 'bot', desc: 'Bot user to get info on.'
+    c.flag 'team_id', desc: 'encoded team id or enterprise id where the bot exists, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.bots_info(options))
     end

data/bin/commands/calls.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'Calls methods.'
+command 'calls' do |g|
+  g.desc 'Registers a new Call.'
+  g.long_desc %( Registers a new Call. )
+  g.command 'add' do |c|
+    c.flag 'external_unique_id', desc: 'An ID supplied by the 3rd-party Call provider. It must be unique across all Calls from that service.'
+    c.flag 'join_url', desc: 'The URL required for a client to join the Call.'
+    c.flag 'created_by', desc: 'The valid Slack user ID of the user who created this Call. When this method is called with a user token, the created_by field is optional and defaults to the authed user of the token. Otherwise, the field is required.'
+    c.flag 'date_start', desc: 'Call start time in UTC UNIX timestamp format.'
+    c.flag 'desktop_app_join_url', desc: 'When supplied, available Slack clients will attempt to directly launch the 3rd-party Call with this URL.'
+    c.flag 'external_display_id', desc: 'An optional, human-readable ID supplied by the 3rd-party Call provider. If supplied, this ID will be displayed in the Call object.'
+    c.flag 'title', desc: 'The name of the Call.'
+    c.flag 'users', desc: 'The list of users to register as participants in the Call. Read more on how to specify users here.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.calls_add(options))
+    end
+  end
+
+  g.desc 'Ends a Call.'
+  g.long_desc %( Ends a Call. )
+  g.command 'end' do |c|
+    c.flag 'id', desc: 'id returned when registering the call using the calls.add method.'
+    c.flag 'duration', desc: 'Call duration in seconds.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.calls_end(options))
+    end
+  end
+
+  g.desc 'Returns information about a Call.'
+  g.long_desc %( Returns information about a Call. )
+  g.command 'info' do |c|
+    c.flag 'id', desc: 'id of the Call returned by the calls.add method.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.calls_info(options))
+    end
+  end
+
+  g.desc 'Updates information about a Call.'
+  g.long_desc %( Updates information about a Call. )
+  g.command 'update' do |c|
+    c.flag 'id', desc: 'id returned by the calls.add method.'
+    c.flag 'desktop_app_join_url', desc: 'When supplied, available Slack clients will attempt to directly launch the 3rd-party Call with this URL.'
+    c.flag 'join_url', desc: 'The URL required for a client to join the Call.'
+    c.flag 'title', desc: 'The name of the Call.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.calls_update(options))
+    end
+  end
+end

data/bin/commands/calls_participants.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'CallsParticipants methods.'
+command 'calls_participants' do |g|
+  g.desc 'Registers new participants added to a Call.'
+  g.long_desc %( Registers new participants added to a Call. )
+  g.command 'add' do |c|
+    c.flag 'id', desc: 'id returned by the calls.add method.'
+    c.flag 'users', desc: 'The list of users to add as participants in the Call. Read more on how to specify users here.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.calls_participants_add(options))
+    end
+  end
+
+  g.desc 'Registers participants removed from a Call.'
+  g.long_desc %( Registers participants removed from a Call. )
+  g.command 'remove' do |c|
+    c.flag 'id', desc: 'id returned by the calls.add method.'
+    c.flag 'users', desc: 'The list of users to remove as participants in the Call. Read more on how to specify users here.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.calls_participants_remove(options))
+    end
+  end
+end

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

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'Chat methods.'
+desc 'Post chat messages to Slack.'
 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 )
@@ -61,7 +61,7 @@ command 'chat' do |g|
   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: "Text of the message to send. See below for an explanation of formatting. This field is usually required, unless you're providing only attachments instead."
+    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 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
@@ -80,16 +80,17 @@ 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: "Text of the message to send. See below for an explanation of formatting. This field is usually required, unless you're providing only attachments instead. Provide no more than 40,000 characters or risk truncation."
     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 '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.'
@@ -104,12 +105,12 @@ command 'chat' do |g|
   g.command 'scheduleMessage' do |c|
     c.flag 'channel', desc: 'Channel, private group, or DM channel to send message to. Can be an encoded ID, or a name. See below for more details.'
     c.flag 'post_at', desc: 'Unix EPOCH timestamp of time in future to send the message.'
-    c.flag 'text', desc: "Text of the message to send. See below for an explanation of formatting. This field is usually required, unless you're providing only attachments instead. Provide no more than 40,000 characters or risk truncation."
-    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 '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 chat.postMessage.'
     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 'link_names', desc: 'Find and link channel names and usernames.'
-    c.flag 'parse', desc: 'Change how messages are treated. Defaults to none. See below.'
+    c.flag 'parse', desc: 'Change how messages are treated. Defaults to none. See chat.postMessage.'
     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 '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.'
@@ -125,7 +126,8 @@ command 'chat' do |g|
     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|
@@ -137,13 +139,13 @@ command 'chat' do |g|
   g.long_desc %( Updates a message. )
   g.command 'update' do |c|
     c.flag 'channel', desc: 'Channel containing the message to be updated.'
-    c.flag 'text', desc: "New text for the message, using the default formatting rules. It's not required when presenting attachments."
     c.flag 'ts', desc: 'Timestamp of the message to be updated.'
     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.'
-    c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
-    c.flag 'link_names', desc: 'Find and link channel names and usernames. Defaults to none. See below.'
-    c.flag 'parse', desc: 'Change how messages are treated. Defaults to client, unlike chat.postMessage. See below.'
+    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 '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 '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))
     end

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

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'Conversations methods.'
+desc "Interface with all kinds of conversations the same way, whether they're public or private channels, direct messages, or otherwise."
 command 'conversations' do |g|
   g.desc 'Archives a conversation.'
   g.long_desc %( Archives a conversation. )
@@ -26,7 +26,7 @@ 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 'user_ids', desc: 'Required for workspace apps. A list of between 1 and 30 human users that will be added to the newly-created conversation. This argument has no effect when used by classic Slack apps.'
+    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
@@ -61,7 +61,7 @@ command 'conversations' do |g|
   g.long_desc %( Invites users to a channel. )
   g.command 'invite' do |c|
     c.flag 'channel', desc: 'The ID of the public or private channel to invite user(s) to.'
-    c.flag 'users', desc: 'A comma separated list of user IDs. Up to 30 users may be listed.'
+    c.flag 'users', desc: 'A comma separated list of user IDs. Up to 1000 users may be listed.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.conversations_invite(options))
     end
@@ -101,12 +101,23 @@ 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 '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|
@@ -143,7 +154,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.'