slack-ruby-client 0.11.0 → 2.7.0

data/lib/slack/web/api/endpoints/stars.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -6,47 +7,59 @@ module Slack
       module Endpoints
         module Stars
           #
-          # Adds a star to an item.
+          # Save an item for later. Formerly known as adding a star.
           #
           # @option options [channel] :channel
           #   Channel to add star to, or channel where the message to add star to was posted (used with timestamp).
           # @option options [file] :file
           #   File to add star to.
-          # @option options [Object] :file_comment
+          # @option options [string] :file_comment
           #   File comment to add star to.
-          # @option options [Object] :timestamp
+          # @option options [string] :timestamp
           #   Timestamp of the message to add star to.
           # @see https://api.slack.com/methods/stars.add
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/stars/stars.add.json
           def stars_add(options = {})
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('stars.add', options)
           end
 
           #
-          # Lists stars for a user.
+          # Listed a user's saved items, formerly known as stars.
           #
+          # @option options [string] :cursor
+          #   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.
+          # @option options [integer] :limit
+          #   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.
+          # @option options [string] :team_id
+          #   encoded team id to list stars in, required if org token is used.
           # @see https://api.slack.com/methods/stars.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/stars/stars.list.json
           def stars_list(options = {})
-            post('stars.list', options)
+            if block_given?
+              Pagination::Cursor.new(self, :stars_list, options).each do |page|
+                yield page
+              end
+            else
+              post('stars.list', options)
+            end
           end
 
           #
-          # Removes a star from an item.
+          # Removes a saved item (star) from an item.
           #
           # @option options [channel] :channel
           #   Channel to remove star from, or channel where the message to remove star from was posted (used with timestamp).
           # @option options [file] :file
           #   File to remove star from.
-          # @option options [Object] :file_comment
+          # @option options [string] :file_comment
           #   File comment to remove star from.
-          # @option options [Object] :timestamp
+          # @option options [string] :timestamp
           #   Timestamp of the message to remove star from.
           # @see https://api.slack.com/methods/stars.remove
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/stars/stars.remove.json
           def stars_remove(options = {})
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             post('stars.remove', options)
           end
         end

data/lib/slack/web/api/endpoints/team.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -8,29 +9,57 @@ module Slack
           #
           # Gets the access logs for the current team.
           #
-          # @option options [Object] :before
+          # @option options [string] :before
           #   End of time range of logs to include in results (inclusive).
+          # @option options [string] :cursor
+          #   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.
+          # @option options [integer] :limit
+          #   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. If specified, result is returned using a cursor-based approach instead of a classic one.
+          # @option options [string] :team_id
+          #   encoded team id to get logs from, required if org token is used.
           # @see https://api.slack.com/methods/team.accessLogs
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team/team.accessLogs.json
           def team_accessLogs(options = {})
-            post('team.accessLogs', options)
+            if block_given?
+              Pagination::Cursor.new(self, :team_accessLogs, options).each do |page|
+                yield page
+              end
+            else
+              post('team.accessLogs', options)
+            end
           end
 
           #
           # Gets billable users information for the current team.
           #
+          # @option options [string] :cursor
+          #   Set cursor to next_cursor returned by previous call, to indicate from where you want to list next page of users list. Default value fetches the first page.
+          # @option options [integer] :limit
+          #   The maximum number of items to return.
+          # @option options [string] :team_id
+          #   encoded team id to get the billable information from, required if org token is used.
           # @option options [user] :user
           #   A user to retrieve the billable information for. Defaults to all users.
           # @see https://api.slack.com/methods/team.billableInfo
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team/team.billableInfo.json
           def team_billableInfo(options = {})
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
-            post('team.billableInfo', options)
+            if block_given?
+              Pagination::Cursor.new(self, :team_billableInfo, options).each do |page|
+                yield page
+              end
+            else
+              post('team.billableInfo', options)
+            end
           end
 
           #
           # Gets information about the current team.
           #
+          # @option options [string] :domain
+          #   Query by domain instead of team (only when team is null). This only works for domains in the same enterprise as the querying team token. This also expects the domain to belong to a team and not the enterprise itself. This is the value set up for the 'Joining This Workspace' workspace setting. If it contains more than one domain, the field will contain multiple comma-separated domain values. If no domain is set, the field is empty.
+          # @option options [string] :team
+          #   Team to get info about; if omitted, will return information about the current team.
           # @see https://api.slack.com/methods/team.info
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team/team.info.json
           def team_info(options = {})
@@ -40,12 +69,14 @@ module Slack
           #
           # Gets the integration logs for the current team.
           #
-          # @option options [Object] :app_id
+          # @option options [string] :app_id
           #   Filter logs to this Slack app. Defaults to all logs.
-          # @option options [Object] :change_type
-          #   Filter logs with this change type. Defaults to all logs.
-          # @option options [Object] :service_id
+          # @option options [enum] :change_type
+          #   Filter logs with this change type. Possible values are added, removed, enabled, disabled, and updated. Defaults to all logs.
+          # @option options [string] :service_id
           #   Filter logs to this service. Defaults to all logs.
+          # @option options [string] :team_id
+          #   encoded team id to get logs from, required if org token is used.
           # @option options [user] :user
           #   Filter logs generated by this user's actions. Defaults to all logs.
           # @see https://api.slack.com/methods/team.integrationLogs

data/lib/slack/web/api/endpoints/team_billing.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module TeamBilling
+          #
+          # Reads a workspace's billing plan information.
+          #
+          # @see https://api.slack.com/methods/team.billing.info
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team.billing/team.billing.info.json
+          def team_billing_info(options = {})
+            post('team.billing.info', options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/slack/web/api/endpoints/team_externalTeams.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module TeamExternalteams
+          #
+          # Disconnect an external organization.
+          #
+          # @option options [Object] :target_team
+          #   The team ID of the target team.
+          # @see https://api.slack.com/methods/team.externalTeams.disconnect
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team.externalTeams/team.externalTeams.disconnect.json
+          def team_externalTeams_disconnect(options = {})
+            raise ArgumentError, 'Required arguments :target_team missing' if options[:target_team].nil?
+            post('team.externalTeams.disconnect', options)
+          end
+
+          #
+          # Returns a list of all the external teams connected and details about the connection.
+          #
+          # @option options [enum] :connection_status_filter
+          #   Status of the connected team.
+          # @option options [string] :cursor
+          #   Paginate through collections of data by setting parameter to the team_id attribute returned by a previous request's response_metadata. If not provided, the first page of the collection is returned. See pagination for more detail.
+          # @option options [integer] :limit
+          #   The maximum number of items to return per page.
+          # @option options [array] :slack_connect_pref_filter
+          #   Filters connected orgs by Slack Connect pref override(s). Value can be: approved_orgs_only allow_sc_file_uploads profile_visibility away_team_sc_invite_permissions accept_sc_invites sc_mpdm_to_private require_sc_channel_for_sc_dm external_awareness_context_bar.
+          # @option options [enum] :sort_direction
+          #   Direction to sort in asc or desc.
+          # @option options [enum] :sort_field
+          #   Name of the parameter that we are sorting by.
+          # @option options [array] :workspace_filter
+          #   Shows connected orgs which are connected on a specified encoded workspace ID.
+          # @see https://api.slack.com/methods/team.externalTeams.list
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team.externalTeams/team.externalTeams.list.json
+          def team_externalTeams_list(options = {})
+            if block_given?
+              Pagination::Cursor.new(self, :team_externalTeams_list, options).each do |page|
+                yield page
+              end
+            else
+              post('team.externalTeams.list', options)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/slack/web/api/endpoints/team_preferences.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module TeamPreferences
+          #
+          # Retrieve a list of a workspace's team preferences.
+          #
+          # @see https://api.slack.com/methods/team.preferences.list
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team.preferences/team.preferences.list.json
+          def team_preferences_list(options = {})
+            post('team.preferences.list', options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/slack/web/api/endpoints/team_profile.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -8,7 +9,7 @@ module Slack
           #
           # Retrieve a team's profile.
           #
-          # @option options [Object] :visibility
+          # @option options [enum] :visibility
           #   Filter by visibility.
           # @see https://api.slack.com/methods/team.profile.get
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team.profile/team.profile.get.json

data/lib/slack/web/api/endpoints/tooling_tokens.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module ToolingTokens
+          #
+          # Exchanges a refresh token for a new app configuration token.
+          #
+          # @option options [string] :refresh_token
+          #   The xoxe refresh token that was issued along with the old app configuration token.
+          # @see https://api.slack.com/methods/tooling.tokens.rotate
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/tooling.tokens/tooling.tokens.rotate.json
+          def tooling_tokens_rotate(options = {})
+            raise ArgumentError, 'Required arguments :refresh_token missing' if options[:refresh_token].nil?
+            post('tooling.tokens.rotate', options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/slack/web/api/endpoints/usergroups.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -6,62 +7,74 @@ module Slack
       module Endpoints
         module Usergroups
           #
-          # Create a User Group
+          # Create a User Group.
           #
-          # @option options [Object] :name
+          # @option options [string] :name
           #   A name for the User Group. Must be unique among User Groups.
-          # @option options [Object] :channels
+          # @option options [array] :additional_channels
+          #   A comma separated string of encoded channel IDs for which the User Group can custom add usergroup members too.
+          # @option options [array] :channels
           #   A comma separated string of encoded channel IDs for which the User Group uses as a default.
-          # @option options [Object] :description
+          # @option options [string] :description
           #   A short description of the User Group.
-          # @option options [Object] :handle
+          # @option options [boolean] :enable_section
+          #   Configure this user group to show as a sidebar section for all group members. Note: Only relevant if group has 1 or more default channels added.
+          # @option options [string] :handle
           #   A mention handle. Must be unique among channels, users and User Groups.
-          # @option options [Object] :include_count
+          # @option options [boolean] :include_count
           #   Include the number of users in each User Group.
+          # @option options [string] :team_id
+          #   Encoded team id where the user group has to be created, required if org token is used.
           # @see https://api.slack.com/methods/usergroups.create
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups/usergroups.create.json
           def usergroups_create(options = {})
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
+            raise ArgumentError, 'Required arguments :name missing' if options[:name].nil?
             post('usergroups.create', options)
           end
 
           #
-          # Disable an existing User Group
+          # Disable an existing User Group.
           #
           # @option options [Object] :usergroup
           #   The encoded ID of the User Group to disable.
-          # @option options [Object] :include_count
+          # @option options [boolean] :include_count
           #   Include the number of users in the User Group.
+          # @option options [Object] :team_id
+          #   Encoded target team id where the user group is, required if org token is used.
           # @see https://api.slack.com/methods/usergroups.disable
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups/usergroups.disable.json
           def usergroups_disable(options = {})
-            throw ArgumentError.new('Required arguments :usergroup missing') if options[:usergroup].nil?
+            raise ArgumentError, 'Required arguments :usergroup missing' if options[:usergroup].nil?
             post('usergroups.disable', options)
           end
 
           #
-          # Enable a User Group
+          # Enable a User Group.
           #
-          # @option options [Object] :usergroup
+          # @option options [string] :usergroup
           #   The encoded ID of the User Group to enable.
-          # @option options [Object] :include_count
+          # @option options [boolean] :include_count
           #   Include the number of users in the User Group.
+          # @option options [string] :team_id
+          #   Encoded team id where the user group is, required if org token is used.
           # @see https://api.slack.com/methods/usergroups.enable
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups/usergroups.enable.json
           def usergroups_enable(options = {})
-            throw ArgumentError.new('Required arguments :usergroup missing') if options[:usergroup].nil?
+            raise ArgumentError, 'Required arguments :usergroup missing' if options[:usergroup].nil?
             post('usergroups.enable', options)
           end
 
           #
-          # List all User Groups for a team
+          # List all User Groups for a team.
           #
-          # @option options [Object] :include_count
+          # @option options [boolean] :include_count
           #   Include the number of users in each User Group.
-          # @option options [Object] :include_disabled
+          # @option options [boolean] :include_disabled
           #   Include disabled User Groups.
-          # @option options [Object] :include_users
+          # @option options [boolean] :include_users
           #   Include the list of users for each User Group.
+          # @option options [string] :team_id
+          #   encoded team id to list user groups in, required if org token is used.
           # @see https://api.slack.com/methods/usergroups.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups/usergroups.list.json
           def usergroups_list(options = {})
@@ -69,24 +82,30 @@ module Slack
           end
 
           #
-          # Update an existing User Group
+          # Update an existing User Group.
           #
           # @option options [Object] :usergroup
           #   The encoded ID of the User Group to update.
-          # @option options [Object] :channels
+          # @option options [array] :additional_channels
+          #   A comma separated string of encoded channel IDs for which the User Group can custom add usergroup members too.
+          # @option options [array] :channels
           #   A comma separated string of encoded channel IDs for which the User Group uses as a default.
-          # @option options [Object] :description
+          # @option options [string] :description
           #   A short description of the User Group.
-          # @option options [Object] :handle
+          # @option options [boolean] :enable_section
+          #   Configure this user group to show as a sidebar section for all group members. Note: Only relevant if group has 1 or more default channels added.
+          # @option options [string] :handle
           #   A mention handle. Must be unique among channels, users and User Groups.
-          # @option options [Object] :include_count
+          # @option options [boolean] :include_count
           #   Include the number of users in the User Group.
-          # @option options [Object] :name
+          # @option options [string] :name
           #   A name for the User Group. Must be unique among User Groups.
+          # @option options [Object] :team_id
+          #   encoded team id where the user group exists, required if org token is used.
           # @see https://api.slack.com/methods/usergroups.update
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups/usergroups.update.json
           def usergroups_update(options = {})
-            throw ArgumentError.new('Required arguments :usergroup missing') if options[:usergroup].nil?
+            raise ArgumentError, 'Required arguments :usergroup missing' if options[:usergroup].nil?
             post('usergroups.update', options)
           end
         end

data/lib/slack/web/api/endpoints/usergroups_users.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -6,33 +7,41 @@ module Slack
       module Endpoints
         module UsergroupsUsers
           #
-          # List all users in a User Group
+          # List all users in a User Group.
           #
-          # @option options [Object] :usergroup
-          #   The encoded ID of the User Group to update.
-          # @option options [Object] :include_disabled
+          # @option options [string] :usergroup
+          #   The encoded ID of the User Group to list users for.
+          # @option options [boolean] :include_disabled
           #   Allow results that involve disabled User Groups.
+          # @option options [string] :team_id
+          #   encoded team id where the user group exists, required if org token is used.
           # @see https://api.slack.com/methods/usergroups.users.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups.users/usergroups.users.list.json
           def usergroups_users_list(options = {})
-            throw ArgumentError.new('Required arguments :usergroup missing') if options[:usergroup].nil?
+            raise ArgumentError, 'Required arguments :usergroup missing' if options[:usergroup].nil?
             post('usergroups.users.list', options)
           end
 
           #
-          # Update the list of users for a User Group
+          # Update the list of users for a user group.
           #
-          # @option options [Object] :usergroup
-          #   The encoded ID of the User Group to update.
-          # @option options [Object] :users
-          #   A comma separated string of encoded user IDs that represent the entire list of users for the User Group.
-          # @option options [Object] :include_count
-          #   Include the number of users in the User Group.
+          # @option options [string] :usergroup
+          #   The encoded ID of the user group to update.
+          # @option options [array] :users
+          #   A comma separated string of encoded user IDs that represent the entire list of users for the user group.
+          # @option options [array] :additional_channels
+          #   A comma separated string of encoded channel IDs for which the User Group can custom add usergroup members too.
+          # @option options [boolean] :include_count
+          #   Include the number of users in the user group.
+          # @option options [boolean] :is_shared
+          #   Boolean to identify if the API is getting called when a shared section is getting shared.
+          # @option options [string] :team_id
+          #   encoded team id where the user group exists, required if org token is used.
           # @see https://api.slack.com/methods/usergroups.users.update
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/usergroups.users/usergroups.users.update.json
           def usergroups_users_update(options = {})
-            throw ArgumentError.new('Required arguments :usergroup missing') if options[:usergroup].nil?
-            throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?
+            raise ArgumentError, 'Required arguments :usergroup missing' if options[:usergroup].nil?
+            raise ArgumentError, 'Required arguments :users missing' if options[:users].nil?
             post('usergroups.users.update', options)
           end
         end

data/lib/slack/web/api/endpoints/users.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -5,6 +6,34 @@ module Slack
     module Api
       module Endpoints
         module Users
+          #
+          # List conversations the calling user may access.
+          #
+          # @option options [string] :cursor
+          #   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.
+          # @option options [boolean] :exclude_archived
+          #   Set to true to exclude archived channels from the list.
+          # @option options [number] :limit
+          #   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 with a max value of 999.
+          # @option options [string] :team_id
+          #   encoded team id to list conversations in, required if org token is used.
+          # @option options [string] :types
+          #   Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im.
+          # @option options [user] :user
+          #   Browse conversations by a specific user ID's membership. Non-public channels are restricted to those where the calling user shares membership.
+          # @see https://api.slack.com/methods/users.conversations
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/users/users.conversations.json
+          def users_conversations(options = {})
+            options = options.merge(user: users_id(options)['user']['id']) if options[:user]
+            if block_given?
+              Pagination::Cursor.new(self, :users_conversations, options).each do |page|
+                yield page
+              end
+            else
+              post('users.conversations', options)
+            end
+          end
+
           #
           # Delete the user profile photo
           #
@@ -22,7 +51,6 @@ module Slack
           # @see https://api.slack.com/methods/users.getPresence
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/users/users.getPresence.json
           def users_getPresence(options = {})
-            throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             post('users.getPresence', options)
           end
@@ -41,12 +69,12 @@ module Slack
           #
           # @option options [user] :user
           #   User to get info on.
-          # @option options [Object] :include_locale
+          # @option options [boolean] :include_locale
           #   Set this to true to receive the locale for this user. Defaults to false.
           # @see https://api.slack.com/methods/users.info
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/users/users.info.json
           def users_info(options = {})
-            throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
+            raise ArgumentError, 'Required arguments :user missing' if options[:user].nil?
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             post('users.info', options)
           end
@@ -54,14 +82,14 @@ module Slack
           #
           # Lists all users in a Slack team.
           #
-          # @option options [Object] :cursor
+          # @option options [string] :cursor
           #   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.
-          # @option options [Object] :include_locale
+          # @option options [boolean] :include_locale
           #   Set this to true to receive the locale for users. Defaults to false.
-          # @option options [Object] :limit
-          #   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.
-          # @option options [Object] :presence
-          #   Whether to include presence data in the output. Setting this to false improves performance, especially with large teams.
+          # @option options [number] :limit
+          #   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.
+          # @option options [string] :team_id
+          #   encoded team id to list users in, required if org token is used.
           # @see https://api.slack.com/methods/users.list
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/users/users.list.json
           def users_list(options = {})
@@ -75,7 +103,19 @@ module Slack
           end
 
           #
-          # Marks a user as active.
+          # Find a user with an email address.
+          #
+          # @option options [string] :email
+          #   An email address belonging to a user in the workspace.
+          # @see https://api.slack.com/methods/users.lookupByEmail
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/users/users.lookupByEmail.json
+          def users_lookupByEmail(options = {})
+            raise ArgumentError, 'Required arguments :email missing' if options[:email].nil?
+            post('users.lookupByEmail', options)
+          end
+
+          #
+          # Marked a user as active. Deprecated and non-functional.
           #
           # @see https://api.slack.com/methods/users.setActive
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/users/users.setActive.json
@@ -86,30 +126,29 @@ module Slack
           #
           # Set the user profile photo
           #
-          # @option options [Object] :image
-          #   File contents via multipart/form-data.
-          # @option options [Object] :crop_w
+          # @option options [string] :crop_w
           #   Width/height of crop box (always square).
-          # @option options [Object] :crop_x
+          # @option options [string] :crop_x
           #   X coordinate of top-left corner of crop box.
-          # @option options [Object] :crop_y
+          # @option options [string] :crop_y
           #   Y coordinate of top-left corner of crop box.
+          # @option options [Object] :image
+          #   File contents via multipart/form-data.
           # @see https://api.slack.com/methods/users.setPhoto
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/users/users.setPhoto.json
           def users_setPhoto(options = {})
-            throw ArgumentError.new('Required arguments :image missing') if options[:image].nil?
             post('users.setPhoto', options)
           end
 
           #
           # Manually sets user presence.
           #
-          # @option options [Object] :presence
+          # @option options [enum] :presence
           #   Either auto or away.
           # @see https://api.slack.com/methods/users.setPresence
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/users/users.setPresence.json
           def users_setPresence(options = {})
-            throw ArgumentError.new('Required arguments :presence missing') if options[:presence].nil?
+            raise ArgumentError, 'Required arguments :presence missing' if options[:presence].nil?
             post('users.setPresence', options)
           end
         end