slack-ruby-client 0.7.9 → 0.16.0

data/bin/commands/im.rb

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Get info on your direct messages.'
 command 'im' do |g|
-  g.desc 'This method closes a direct message channel.'
-  g.long_desc %( This method closes a direct message channel. )
+  g.desc 'Close a direct message channel.'
+  g.long_desc %( Close a direct message channel. )
   g.command 'close' do |c|
     c.flag 'channel', desc: 'Direct message channel to close.'
     c.action do |_global_options, options, _args|
@@ -11,29 +12,31 @@ command 'im' do |g|
     end
   end
 
-  g.desc 'This method returns a portion of messages/events from the specified direct message channel.'
-  g.long_desc %( This method returns a portion of messages/events from the specified direct message channel. To read the entire history for a direct message channel, call the method with no latest or oldest arguments, and then continue paging using the instructions below. )
+  g.desc 'Fetches history of messages and events from direct message channel.'
+  g.long_desc %( Fetches history of messages and events from direct message channel. )
   g.command 'history' do |c|
     c.flag 'channel', desc: 'Direct message 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 'inclusive', desc: 'Include messages with latest or oldest timestamp in results.'
     c.flag 'unreads', desc: 'Include unread_count_display in the output?.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.im_history(options))
     end
   end
 
-  g.desc 'This method returns a list of all im channels that the user has.'
-  g.long_desc %( This method returns a list of all im channels that the user has. )
+  g.desc 'Lists direct message channels for the calling user.'
+  g.long_desc %( Lists direct message channels for the calling user. )
   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 '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.im_list(options))
     end
   end
 
-  g.desc 'This method moves the read cursor in a direct message channel.'
-  g.long_desc %( This method moves the read cursor in a direct message channel. )
+  g.desc 'Sets the read cursor in a direct message channel.'
+  g.long_desc %( Sets the read cursor in a direct message channel. )
   g.command 'mark' do |c|
     c.flag 'channel', desc: 'Direct message channel to set reading cursor in.'
     c.flag 'ts', desc: 'Timestamp of the most recently seen message.'
@@ -42,18 +45,19 @@ command 'im' do |g|
     end
   end
 
-  g.desc 'This method opens a direct message channel with another member of your Slack team.'
-  g.long_desc %( This method opens a direct message channel with another member of your Slack team. )
+  g.desc 'Opens a direct message channel.'
+  g.long_desc %( Opens a direct message channel. )
   g.command 'open' do |c|
     c.flag 'user', desc: 'User to open a direct message channel with.'
+    c.flag 'include_locale', desc: 'Set this to true to receive the locale for this im. Defaults to false.'
     c.flag 'return_im', desc: 'Boolean, indicates you want the full IM channel definition in the response.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.im_open(options))
     end
   end
 
-  g.desc 'This method returns an entire thread (a message plus all the messages in reply to it).'
-  g.long_desc %( This method returns an entire thread (a message plus all the messages in reply to it). )
+  g.desc 'Retrieve a thread of messages posted to a direct message conversation'
+  g.long_desc %( Retrieve a thread of messages posted to a direct message conversation )
   g.command 'replies' do |c|
     c.flag 'channel', desc: 'Direct message channel to fetch thread from.'
     c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."

data/bin/commands/migration.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'Migration methods.'
+command 'migration' do |g|
+  g.desc 'For Enterprise Grid workspaces, map local user IDs to global user IDs'
+  g.long_desc %( For Enterprise Grid workspaces, map local user IDs to global user IDs )
+  g.command 'exchange' do |c|
+    c.flag 'users', desc: 'A comma-separated list of user ids, up to 400 per request.'
+    c.flag 'team_id', desc: 'Specify team_id starts with T in case of Org Token.'
+    c.flag 'to_old', desc: 'Specify true to convert W global user IDs to workspace-specific U IDs. Defaults to false.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.migration_exchange(options))
+    end
+  end
+end

data/bin/commands/mpim.rb

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Get info on your multiparty direct messages.'
 command 'mpim' do |g|
-  g.desc 'This method closes a multiparty direct message channel.'
-  g.long_desc %( This method closes a multiparty direct message channel. )
+  g.desc 'Closes a multiparty direct message channel.'
+  g.long_desc %( Closes a multiparty direct message channel. )
   g.command 'close' do |c|
     c.flag 'channel', desc: 'MPIM to close.'
     c.action do |_global_options, options, _args|
@@ -11,32 +12,34 @@ command 'mpim' do |g|
     end
   end
 
-  g.desc 'This method returns a portion of messages/events from the specified multiparty direct message channel.'
-  g.long_desc %( This method returns a portion of messages/events from the specified multiparty direct message channel. To read the entire history for a multiparty direct message, call the method with no latest or oldest arguments, and then continue paging using the instructions below. )
+  g.desc 'Fetches history of messages and events from a multiparty direct message.'
+  g.long_desc %( Fetches history of messages and events from a multiparty direct message. )
   g.command 'history' do |c|
     c.flag 'channel', desc: 'Multiparty direct message 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 'inclusive', desc: 'Include messages with latest or oldest timestamp in results.'
     c.flag 'unreads', desc: 'Include unread_count_display in the output?.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.mpim_history(options))
     end
   end
 
-  g.desc 'This method returns a list of all multiparty direct message channels that the user has.'
-  g.long_desc %( This method returns a list of all multiparty direct message channels that the user has. )
+  g.desc 'Lists multiparty direct message channels for the calling user.'
+  g.long_desc %( Lists multiparty direct message channels for the calling user. )
   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 '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.mpim_list(options))
     end
   end
 
-  g.desc 'This method moves the read cursor in a multiparty direct message channel.'
-  g.long_desc %( This method moves the read cursor in a multiparty direct message channel. )
+  g.desc 'Sets the read cursor in a multiparty direct message channel.'
+  g.long_desc %( Sets the read cursor in a multiparty direct message channel. )
   g.command 'mark' do |c|
-    c.flag 'channel', desc: 'multiparty direct message channel to set reading cursor in.'
-    c.flag 'ts', desc: 'Timestamp of the most recently seen message.'
+    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.mpim_mark(options))
     end
@@ -51,8 +54,8 @@ command 'mpim' do |g|
     end
   end
 
-  g.desc 'This method returns an entire thread (a message plus all the messages in reply to it).'
-  g.long_desc %( This method returns an entire thread (a message plus all the messages in reply to it). )
+  g.desc 'Retrieve a thread of messages posted to a direct message conversation from a multiparty direct message.'
+  g.long_desc %( Retrieve a thread of messages posted to a direct message conversation from a multiparty direct message. )
   g.command 'replies' do |c|
     c.flag 'channel', desc: 'Multiparty direct message channel to fetch thread from.'
     c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."

data/bin/commands/oauth.rb

@@ -1,16 +1,31 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Oauth methods.'
 command 'oauth' do |g|
-  g.desc 'This method allows you to exchange a temporary OAuth code for an API access token.'
-  g.long_desc %( This method allows you to exchange a temporary OAuth code for an API access token. This is used as part of the OAuth authentication flow. )
+  g.desc 'Exchanges a temporary OAuth verifier code for an access token.'
+  g.long_desc %( Exchanges a temporary OAuth verifier code for an access token. )
   g.command 'access' do |c|
     c.flag 'client_id', desc: 'Issued when you created your application.'
     c.flag 'client_secret', desc: 'Issued when you created your application.'
     c.flag 'code', desc: 'The code param returned via the OAuth callback.'
     c.flag 'redirect_uri', desc: 'This must match the originally submitted URI (if one was sent).'
+    c.flag 'single_channel', desc: 'Request the user to add your app only to a single channel. Only valid with a legacy workspace app.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.oauth_access(options))
     end
   end
+
+  g.desc 'Exchanges a temporary OAuth verifier code for a workspace token.'
+  g.long_desc %( Exchanges a temporary OAuth verifier code for a workspace token. )
+  g.command 'token' do |c|
+    c.flag 'client_id', desc: 'Issued when you created your application.'
+    c.flag 'client_secret', desc: 'Issued when you created your application.'
+    c.flag 'code', desc: 'The code param returned via the OAuth callback.'
+    c.flag 'redirect_uri', desc: 'This must match the originally submitted URI (if one was sent).'
+    c.flag 'single_channel', desc: 'Request the user to add your app only to a single channel.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.oauth_token(options))
+    end
+  end
 end

data/bin/commands/oauth_v2.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'OauthV2 methods.'
+command 'oauth_v2' do |g|
+  g.desc 'Exchanges a temporary OAuth verifier code for an access token.'
+  g.long_desc %( Exchanges a temporary OAuth verifier code for an access token. )
+  g.command 'access' do |c|
+    c.flag 'code', desc: 'The code param returned via the OAuth callback.'
+    c.flag 'client_id', desc: 'Issued when you created your application.'
+    c.flag 'client_secret', desc: 'Issued when you created your application.'
+    c.flag 'redirect_uri', desc: 'This must match the originally submitted URI (if one was sent).'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.oauth_v2_access(options))
+    end
+  end
+end

data/bin/commands/pins.rb

@@ -1,21 +1,20 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Pins methods.'
 command 'pins' do |g|
-  g.desc 'This method pins an item (file, file comment, channel message, or group message) to a particular channel.'
-  g.long_desc %( This method pins an item (file, file comment, channel message, or group message) to a particular channel. The channel argument is required and one of file, file_comment, or timestamp must also be specified. )
+  g.desc 'Pins an item to a channel.'
+  g.long_desc %( Pins an item to a channel. )
   g.command 'add' do |c|
     c.flag 'channel', desc: 'Channel to pin the item in.'
-    c.flag 'file', desc: 'File to pin.'
-    c.flag 'file_comment', desc: 'File comment to pin.'
     c.flag 'timestamp', desc: 'Timestamp of the message to pin.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.pins_add(options))
     end
   end
 
-  g.desc 'This method lists the items pinned to a channel.'
-  g.long_desc %( This method lists the items pinned to a channel. )
+  g.desc 'Lists items pinned to a channel.'
+  g.long_desc %( Lists items pinned to a channel. )
   g.command 'list' do |c|
     c.flag 'channel', desc: 'Channel to get pinned items for.'
     c.action do |_global_options, options, _args|
@@ -23,12 +22,10 @@ command 'pins' do |g|
     end
   end
 
-  g.desc 'This method un-pins an item (file, file comment, channel message, or group message) from a channel.'
-  g.long_desc %( This method un-pins an item (file, file comment, channel message, or group message) from a channel. The channel argument is required and one of file, file_comment, or timestamp must also be specified. )
+  g.desc 'Un-pins an item from a channel.'
+  g.long_desc %( Un-pins an item from a channel. )
   g.command 'remove' do |c|
     c.flag 'channel', desc: 'Channel where the item is pinned to.'
-    c.flag 'file', desc: 'File to un-pin.'
-    c.flag 'file_comment', desc: 'File comment to un-pin.'
     c.flag 'timestamp', desc: 'Timestamp of the message to un-pin.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.pins_remove(options))

data/bin/commands/reactions.rb

@@ -1,50 +1,52 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Reactions methods.'
 command 'reactions' do |g|
-  g.desc 'This method adds a reaction (emoji) to an item (file, file comment, channel message, group message, or direct message).'
-  g.long_desc %( This method adds a reaction (emoji) to an item (file, file comment, channel message, group message, or direct message). One of file, file_comment, or the combination of channel and timestamp must be specified. )
+  g.desc 'Adds a reaction to an item.'
+  g.long_desc %( Adds a reaction to an item. )
   g.command 'add' do |c|
-    c.flag 'name', desc: 'Reaction (emoji) name.'
-    c.flag 'file', desc: 'File to add reaction to.'
-    c.flag 'file_comment', desc: 'File comment to add reaction to.'
     c.flag 'channel', desc: 'Channel where the message to add reaction to was posted.'
+    c.flag 'name', desc: 'Reaction (emoji) name.'
     c.flag 'timestamp', desc: 'Timestamp of the message to add reaction to.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.reactions_add(options))
     end
   end
 
-  g.desc 'This method returns a list of all reactions for a single item (file, file comment, channel message, group message, or direct message).'
-  g.long_desc %( This method returns a list of all reactions for a single item (file, file comment, channel message, group message, or direct message). )
+  g.desc 'Gets reactions for an item.'
+  g.long_desc %( Gets reactions for an item. )
   g.command 'get' do |c|
+    c.flag 'channel', desc: 'Channel where the message to get reactions for was posted.'
     c.flag 'file', desc: 'File to get reactions for.'
     c.flag 'file_comment', desc: 'File comment to get reactions for.'
-    c.flag 'channel', desc: 'Channel where the message to get reactions for was posted.'
-    c.flag 'timestamp', desc: 'Timestamp of the message to get reactions for.'
     c.flag 'full', desc: 'If true always return the complete reaction list.'
+    c.flag 'timestamp', desc: 'Timestamp of the message to get reactions for.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.reactions_get(options))
     end
   end
 
-  g.desc 'This method returns a list of all items (file, file comment, channel message, group message, or direct message) reacted to by a user.'
-  g.long_desc %( This method returns a list of all items (file, file comment, channel message, group message, or direct message) reacted to by a user. )
+  g.desc 'Lists reactions made by a user.'
+  g.long_desc %( Lists reactions made by a user. )
   g.command 'list' do |c|
-    c.flag 'user', desc: 'Show reactions made by this user. Defaults to the authed user.'
+    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 'full', desc: 'If true always return the complete reaction 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."
+    c.flag 'team_id', desc: 'encoded team id to list reactions in, required if org token is used.'
+    c.flag 'user', desc: 'Show reactions made by this user. Defaults to the authed user.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.reactions_list(options))
     end
   end
 
-  g.desc 'This method removes a reaction (emoji) from an item (file, file comment, channel message, group message, or direct message).'
-  g.long_desc %( This method removes a reaction (emoji) from an item (file, file comment, channel message, group message, or direct message). One of file, file_comment, or the combination of channel and timestamp must be specified. )
+  g.desc 'Removes a reaction from an item.'
+  g.long_desc %( Removes a reaction from an item. )
   g.command 'remove' do |c|
     c.flag 'name', desc: 'Reaction (emoji) name.'
+    c.flag 'channel', desc: 'Channel where the message to remove reaction from was posted.'
     c.flag 'file', desc: 'File to remove reaction from.'
     c.flag 'file_comment', desc: 'File comment to remove reaction from.'
-    c.flag 'channel', desc: 'Channel where the message to remove reaction from was posted.'
     c.flag 'timestamp', desc: 'Timestamp of the message to remove reaction from.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.reactions_remove(options))

data/bin/commands/reminders.rb

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Reminders methods.'
 command 'reminders' do |g|
-  g.desc 'This method creates a reminder.'
-  g.long_desc %( This method creates a reminder. )
+  g.desc 'Creates a reminder.'
+  g.long_desc %( Creates a reminder. )
   g.command 'add' do |c|
     c.flag 'text', desc: 'The content of the reminder.'
     c.flag 'time', desc: 'When this reminder should happen: the Unix timestamp (up to five years from now), the number of seconds until the reminder (if within 24 hours), or a natural language description (Ex. "in 15 minutes," or "every Thursday").'
@@ -13,8 +14,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'This method completes a reminder.'
-  g.long_desc %( This method completes a reminder. )
+  g.desc 'Marks a reminder as complete.'
+  g.long_desc %( Marks a reminder as complete. )
   g.command 'complete' do |c|
     c.flag 'reminder', desc: 'The ID of the reminder to be marked as complete.'
     c.action do |_global_options, options, _args|
@@ -22,8 +23,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'This method deletes a reminder.'
-  g.long_desc %( This method deletes a reminder. )
+  g.desc 'Deletes a reminder.'
+  g.long_desc %( Deletes a reminder. )
   g.command 'delete' do |c|
     c.flag 'reminder', desc: 'The ID of the reminder.'
     c.action do |_global_options, options, _args|
@@ -31,8 +32,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'This method returns information about a reminder.'
-  g.long_desc %( This method returns information about a reminder. )
+  g.desc 'Gets information about a reminder.'
+  g.long_desc %( Gets information about a reminder. )
   g.command 'info' do |c|
     c.flag 'reminder', desc: 'The ID of the reminder.'
     c.action do |_global_options, options, _args|
@@ -40,8 +41,8 @@ command 'reminders' do |g|
     end
   end
 
-  g.desc 'This method lists all reminders created by or for a given user.'
-  g.long_desc %( This method lists all reminders created by or for a given user. )
+  g.desc 'Lists all reminders created by or for a given user.'
+  g.long_desc %( Lists all reminders created by or for a given user. )
   g.command 'list' do |c|
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.reminders_list(options))

data/bin/commands/rtm.rb

@@ -1,13 +1,28 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Rtm methods.'
 command 'rtm' do |g|
-  g.desc 'This method starts a Real Time Messaging API session. Refer to the'
-  g.long_desc %( This method starts a Real Time Messaging API session. Refer to the RTM API documentation for full details on how to use the RTM API. )
+  g.desc 'Starts a Real Time Messaging session.'
+  g.long_desc %( Starts a Real Time Messaging session. )
+  g.command 'connect' do |c|
+    c.flag 'batch_presence_aware', desc: 'Batch presence deliveries via subscription. Enabling changes the shape of presence_change events. See batch presence.'
+    c.flag 'presence_sub', desc: 'Only deliver presence events when requested by subscription. See presence subscriptions.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.rtm_connect(options))
+    end
+  end
+
+  g.desc 'Starts a Real Time Messaging session.'
+  g.long_desc %( Starts a Real Time Messaging session. )
   g.command 'start' do |c|
-    c.flag 'simple_latest', desc: 'Return timestamp only for latest message object of each channel (improves performance).'
-    c.flag 'no_unreads', desc: 'Skip unread counts for each channel (improves performance).'
+    c.flag 'batch_presence_aware', desc: 'Batch presence deliveries via subscription. Enabling changes the shape of presence_change events. See batch presence.'
+    c.flag 'include_locale', desc: 'Set this to true to receive the locale for users and channels. Defaults to false.'
     c.flag 'mpim_aware', desc: 'Returns MPIMs to the client in the API response.'
+    c.flag 'no_latest', desc: 'Exclude latest timestamps for channels, groups, mpims, and ims. Automatically sets no_unreads to 1.'
+    c.flag 'no_unreads', desc: 'Skip unread counts for each channel (improves performance).'
+    c.flag 'presence_sub', desc: 'Only deliver presence events when requested by subscription. See presence subscriptions.'
+    c.flag 'simple_latest', desc: 'Return timestamp only for latest message object of each channel (improves performance).'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.rtm_start(options))
     end

data/bin/commands/search.rb

@@ -1,38 +1,42 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc "Search your team's files and messages."
 command 'search' do |g|
-  g.desc 'This method allows users and applications to search both messages and files in a single call.'
-  g.long_desc %( This method allows users and applications to search both messages and files in a single call. )
+  g.desc 'Searches for messages and files matching a query.'
+  g.long_desc %( Searches for messages and files matching a query. )
   g.command 'all' do |c|
     c.flag 'query', desc: 'Search query. May contains booleans, etc.'
+    c.flag 'highlight', desc: 'Pass a value of true to enable query highlight markers (see below).'
     c.flag 'sort', desc: 'Return matches sorted by either score or timestamp.'
     c.flag 'sort_dir', desc: 'Change sort direction to ascending (asc) or descending (desc).'
-    c.flag 'highlight', desc: 'Pass a value of 1 to enable query highlight markers (see below).'
+    c.flag 'team_id', desc: 'encoded team id to search in, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.search_all(options))
     end
   end
 
-  g.desc 'This method returns files matching a search query.'
-  g.long_desc %( This method returns files matching a search query. )
+  g.desc 'Searches for files matching a query.'
+  g.long_desc %( Searches for files matching a query. )
   g.command 'files' do |c|
-    c.flag 'query', desc: 'Search query. May contain booleans, etc.'
+    c.flag 'query', desc: 'Search query.'
+    c.flag 'highlight', desc: 'Pass a value of true to enable query highlight markers (see below).'
     c.flag 'sort', desc: 'Return matches sorted by either score or timestamp.'
     c.flag 'sort_dir', desc: 'Change sort direction to ascending (asc) or descending (desc).'
-    c.flag 'highlight', desc: 'Pass a value of 1 to enable query highlight markers (see below).'
+    c.flag 'team_id', desc: 'encoded team id to search in, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.search_files(options))
     end
   end
 
-  g.desc 'This method returns messages matching a search query.'
-  g.long_desc %( This method returns messages matching a search query. )
+  g.desc 'Searches for messages matching a query.'
+  g.long_desc %( Searches for messages matching a query. )
   g.command 'messages' do |c|
-    c.flag 'query', desc: 'Search query. May contains booleans, etc.'
+    c.flag 'query', desc: 'Search query.'
+    c.flag 'highlight', desc: 'Pass a value of true to enable query highlight markers (see below).'
     c.flag 'sort', desc: 'Return matches sorted by either score or timestamp.'
     c.flag 'sort_dir', desc: 'Change sort direction to ascending (asc) or descending (desc).'
-    c.flag 'highlight', desc: 'Pass a value of 1 to enable query highlight markers (see below).'
+    c.flag 'team_id', desc: 'encoded team id to search in, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.search_messages(options))
     end