slack-ruby-client 0.13.0 → 0.17.0

data/bin/commands/im.rb

@@ -1,67 +1,6 @@
+# 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 '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|
-      puts JSON.dump($client.im_close(options))
-    end
-  end
-
-  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 '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 '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 '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.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.im_mark(options))
-    end
-  end
-
-  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 '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."
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.im_replies(options))
-    end
-  end
 end

data/bin/commands/migration.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Migration methods.'
@@ -6,6 +7,7 @@ command 'migration' do |g|
   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))

data/bin/commands/mpim.rb

@@ -1,65 +1,6 @@
+# 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 '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|
-      puts JSON.dump($client.mpim_close(options))
-    end
-  end
-
-  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 '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 '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 '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.action do |_global_options, options, _args|
-      puts JSON.dump($client.mpim_mark(options))
-    end
-  end
-
-  g.desc 'This method opens a multiparty direct message.'
-  g.long_desc %( This method opens a multiparty direct message. )
-  g.command 'open' do |c|
-    c.flag 'users', desc: 'Comma separated lists of users.  The ordering of the users is preserved whenever a MPIM group is returned.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.mpim_open(options))
-    end
-  end
-
-  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."
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.mpim_replies(options))
-    end
-  end
 end

data/bin/commands/oauth.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Oauth methods.'
@@ -9,7 +10,7 @@ command 'oauth' do |g|
     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.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

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,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Pins methods.'
@@ -6,8 +7,6 @@ command 'pins' do |g|
   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))
@@ -27,8 +26,6 @@ command 'pins' do |g|
   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,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Reactions methods.'
@@ -5,10 +6,8 @@ command 'reactions' do |g|
   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 'channel', desc: 'Channel where the message to add reaction to was posted.'
-    c.flag 'file', desc: 'File to add reaction to.'
-    c.flag 'file_comment', desc: 'File comment to add reaction to.'
+    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))
@@ -34,6 +33,7 @@ command 'reactions' do |g|
     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))

data/bin/commands/reminders.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Reminders methods.'

data/bin/commands/rtm.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Rtm methods.'

data/bin/commands/search.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc "Search your team's files and messages."
@@ -9,6 +10,7 @@ command 'search' do |g|
     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 '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
@@ -21,6 +23,7 @@ command 'search' do |g|
     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 '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
@@ -33,6 +36,7 @@ command 'search' do |g|
     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 '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

data/bin/commands/stars.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Stars methods.'

data/bin/commands/team.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Team methods.'
@@ -6,6 +7,7 @@ command 'team' do |g|
   g.long_desc %( Gets the access logs for the current team. )
   g.command 'accessLogs' do |c|
     c.flag 'before', desc: 'End of time range of logs to include in results (inclusive).'
+    c.flag 'team_id', desc: 'encoded team id to get logs from, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.team_accessLogs(options))
     end
@@ -14,6 +16,7 @@ command 'team' do |g|
   g.desc 'Gets billable users information for the current team.'
   g.long_desc %( Gets billable users information for the current team. )
   g.command 'billableInfo' do |c|
+    c.flag 'team_id', desc: 'encoded team id to get the billable information from, required if org token is used.'
     c.flag 'user', desc: 'A user to retrieve the billable information for. Defaults to all users.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.team_billableInfo(options))
@@ -23,6 +26,7 @@ command 'team' do |g|
   g.desc 'Gets information about the current team.'
   g.long_desc %( Gets information about the current team. )
   g.command 'info' do |c|
+    c.flag 'team', desc: 'Team to get info on, if omitted, will return information about the current team. Will only return team that the authenticated token is allowed to see through external shared channels.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.team_info(options))
     end
@@ -34,6 +38,7 @@ command 'team' do |g|
     c.flag 'app_id', desc: 'Filter logs to this Slack app. Defaults to all logs.'
     c.flag 'change_type', desc: 'Filter logs with this change type. Defaults to all logs.'
     c.flag 'service_id', desc: 'Filter logs to this service. Defaults to all logs.'
+    c.flag 'team_id', desc: 'encoded team id to get logs from, required if org token is used.'
     c.flag 'user', desc: "Filter logs generated by this user's actions. Defaults to all logs."
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.team_integrationLogs(options))

data/bin/commands/team_profile.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'TeamProfile methods.'

data/bin/commands/usergroups.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc "Get info on your team's User Groups."
@@ -10,6 +11,7 @@ command 'usergroups' do |g|
     c.flag 'description', desc: 'A short description of the User Group.'
     c.flag 'handle', desc: 'A mention handle. Must be unique among channels, users and User Groups.'
     c.flag 'include_count', desc: 'Include the number of users in each User Group.'
+    c.flag 'team_id', desc: 'Encoded team id where the user group has to be created, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.usergroups_create(options))
     end
@@ -20,6 +22,7 @@ command 'usergroups' do |g|
   g.command 'disable' do |c|
     c.flag 'usergroup', desc: 'The encoded ID of the User Group to disable.'
     c.flag 'include_count', desc: 'Include the number of users in the User Group.'
+    c.flag 'team_id', desc: 'Encoded team id where the user group is, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.usergroups_disable(options))
     end
@@ -30,6 +33,7 @@ command 'usergroups' do |g|
   g.command 'enable' do |c|
     c.flag 'usergroup', desc: 'The encoded ID of the User Group to enable.'
     c.flag 'include_count', desc: 'Include the number of users in the User Group.'
+    c.flag 'team_id', desc: 'Encoded team id where the user group is, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.usergroups_enable(options))
     end
@@ -41,6 +45,7 @@ command 'usergroups' do |g|
     c.flag 'include_count', desc: 'Include the number of users in each User Group.'
     c.flag 'include_disabled', desc: 'Include disabled User Groups.'
     c.flag 'include_users', desc: 'Include the list of users for each User Group.'
+    c.flag 'team_id', desc: 'encoded team id to list user groups in, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.usergroups_list(options))
     end
@@ -55,6 +60,7 @@ command 'usergroups' do |g|
     c.flag 'handle', desc: 'A mention handle. Must be unique among channels, users and User Groups.'
     c.flag 'include_count', desc: 'Include the number of users in the User Group.'
     c.flag 'name', desc: 'A name for the User Group. Must be unique among User Groups.'
+    c.flag 'team_id', desc: 'encoded team id where the user group exists, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.usergroups_update(options))
     end

data/bin/commands/usergroups_users.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'UsergroupsUsers methods.'
@@ -7,6 +8,7 @@ command 'usergroups_users' do |g|
   g.command 'list' do |c|
     c.flag 'usergroup', desc: 'The encoded ID of the User Group to update.'
     c.flag 'include_disabled', desc: 'Allow results that involve disabled User Groups.'
+    c.flag 'team_id', desc: 'encoded team id where the user group exists, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.usergroups_users_list(options))
     end
@@ -18,6 +20,7 @@ command 'usergroups_users' do |g|
     c.flag 'usergroup', desc: 'The encoded ID of the User Group to update.'
     c.flag 'users', desc: 'A comma separated string of encoded user IDs that represent the entire list of users for the User Group.'
     c.flag 'include_count', desc: 'Include the number of users in the User Group.'
+    c.flag 'team_id', desc: 'encoded team id where the user group exists, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.usergroups_users_update(options))
     end

data/bin/commands/users.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'Get info on members of your Slack team.'
@@ -8,6 +9,7 @@ command 'users' 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 conversations in, required if org token is used.'
     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.flag 'user', desc: "Browse conversations by a specific user ID's membership. Non-public channels are restricted to those where the calling user shares membership."
     c.action do |_global_options, options, _args|
@@ -64,8 +66,8 @@ command 'users' do |g|
   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 'include_locale', desc: 'Set this to true to receive the locale for users. Defaults to false.'
-    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 'presence', desc: 'Deprecated. Whether to include presence data in the output. Defaults to false. Setting this to true reduces performance, especially with large teams.'
+    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. Providing no limit value will result in Slack attempting to deliver you the entire result set. If the collection is too large you may experience limit_required or HTTP 500 errors."
+    c.flag 'team_id', desc: 'encoded team id to list users in, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.users_list(options))
     end
@@ -100,10 +102,10 @@ command 'users' do |g|
   g.desc 'Set the user profile photo'
   g.long_desc %( Set the user profile photo )
   g.command 'setPhoto' do |c|
-    c.flag 'image', desc: 'File contents via multipart/form-data.'
     c.flag 'crop_w', desc: 'Width/height of crop box (always square).'
     c.flag 'crop_x', desc: 'X coordinate of top-left corner of crop box.'
     c.flag 'crop_y', desc: 'Y coordinate of top-left corner of crop box.'
+    c.flag 'image', desc: 'File contents via multipart/form-data.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.users_setPhoto(options))
     end

data/bin/commands/users_admin.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'UsersAdmin methods.'

data/bin/commands/users_prefs.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'UsersPrefs methods.'

data/bin/commands/users_profile.rb

@@ -1,19 +1,20 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 desc 'UsersProfile methods.'
 command 'users_profile' do |g|
-  g.desc "Retrieves a user's profile information."
-  g.long_desc %( Retrieves a user's profile information. )
+  g.desc "Retrieve a user's profile information, including their custom status."
+  g.long_desc %( Retrieve a user's profile information, including their custom status. )
   g.command 'get' do |c|
-    c.flag 'include_labels', desc: 'Include labels for each ID in custom profile fields.'
+    c.flag 'include_labels', desc: 'Include labels for each ID in custom profile fields. Using this parameter will heavily rate-limit your requests and is not recommended.'
     c.flag 'user', desc: 'User to retrieve profile info for.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.users_profile_get(options))
     end
   end
 
-  g.desc 'Set the profile information for a user.'
-  g.long_desc %( Set the profile information for a user. )
+  g.desc "Set a user's profile information, including custom status."
+  g.long_desc %( Set a user's profile information, including custom status. )
   g.command 'set' do |c|
     c.flag 'name', desc: 'Name of a single key to set. Usable only if profile is not passed.'
     c.flag 'profile', desc: 'Collection of key:value pairs presented as a URL-encoded JSON hash. At most 50 fields may be set. Each field name is limited to 255 characters.'