slack-ruby-client 2.2.0 → 2.3.0

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

@@ -96,16 +96,16 @@ module Slack
           #
           # @option options [channel] :channel
           #   Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name.
-          # @option options [string] :text
-          #   How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.
           # @option options [user] :user
           #   id of the user who will receive the ephemeral message. The user should be in the channel specified by the channel argument.
-          # @option options [boolean] :as_user
-          #   (Legacy) 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.
           # @option options [string] :attachments
           #   A JSON-based array of structured attachments, presented as a URL-encoded string.
           # @option options [blocks[] as string] :blocks
           #   A JSON-based array of structured blocks, presented as a URL-encoded string.
+          # @option options [string] :text
+          #   How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.
+          # @option options [boolean] :as_user
+          #   (Legacy) 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.
           # @option options [string] :icon_emoji
           #   Emoji to use as the icon for this message. Overrides icon_url.
           # @option options [string] :icon_url
@@ -122,8 +122,8 @@ module Slack
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postEphemeral.json
           def chat_postEphemeral(options = {})
             raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
-            raise ArgumentError, 'At least one of :attachments, :blocks, :text is required' if options[:attachments].nil? && options[:blocks].nil? && options[:text].nil?
             raise ArgumentError, 'Required arguments :user missing' if options[:user].nil?
+            raise ArgumentError, 'At least one of :attachments, :blocks, :text is required' if options[:attachments].nil? && options[:blocks].nil? && options[:text].nil?
             options = options.merge(user: users_id(options)['user']['id']) if options[:user]
             options = encode_options_as_json(options, %i[attachments blocks])
             post('chat.postEphemeral', options)
@@ -139,7 +139,7 @@ module Slack
           # @option options [blocks[] as string] :blocks
           #   A JSON-based array of structured blocks, presented as a URL-encoded string.
           # @option options [string] :text
-          #   The formatted text of the message to be published. If blocks are included, this will become the fallback text used in notifications.
+          #   How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.
           # @option options [boolean] :as_user
           #   (Legacy) Pass true to post the message as the authed user instead of as a bot. Defaults to false. Can only be used by classic Slack apps. See authorship below.
           # @option options [string] :icon_emoji
@@ -179,20 +179,20 @@ module Slack
           # @option options [channel] :channel
           #   Channel, private group, or DM channel to send message to. Can be an encoded ID, or a name. See below for more details.
           # @option options [integer] :post_at
-          #   Unix EPOCH timestamp of time in future to send the message.
-          # @option options [string] :text
-          #   How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.
-          # @option options [boolean] :as_user
-          #   Set to true to post the message as the authed user, instead of as a bot. Defaults to false. Cannot be used by new Slack apps. See chat.postMessage.
+          #   Unix timestamp representing the future time the message should post to Slack.
           # @option options [string] :attachments
           #   A JSON-based array of structured attachments, presented as a URL-encoded string.
           # @option options [blocks[] as string] :blocks
           #   A JSON-based array of structured blocks, presented as a URL-encoded string.
+          # @option options [string] :text
+          #   How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.
+          # @option options [boolean] :as_user
+          #   Set to true to post the message as the authed user, instead of as a bot. Defaults to false. Cannot be used by new Slack apps. See chat.postMessage.
           # @option options [boolean] :link_names
           #   Find and link user groups. No longer supports linking individual users; use syntax shown in Mentioning Users instead.
           # @option options [string] :metadata
           #   JSON object with event_type and event_payload fields, presented as a URL-encoded string. Metadata you post to Slack is accessible to any app or user who is a member of that workspace.
-          # @option options [string] :parse
+          # @option options [enum] :parse
           #   Change how messages are treated. See chat.postMessage.
           # @option options [boolean] :reply_broadcast
           #   Used in conjunction with thread_ts and indicates whether reply should be made visible to everyone in the channel or conversation. Defaults to false.
@@ -207,7 +207,7 @@ module Slack
           def chat_scheduleMessage(options = {})
             raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             raise ArgumentError, 'Required arguments :post_at missing' if options[:post_at].nil?
-            raise ArgumentError, 'Required arguments :text missing' if options[:text].nil?
+            raise ArgumentError, 'At least one of :attachments, :blocks, :text is required' if options[:attachments].nil? && options[:blocks].nil? && options[:text].nil?
             options = encode_options_as_json(options, %i[attachments blocks metadata])
             post('chat.scheduleMessage', options)
           end
@@ -221,7 +221,7 @@ module Slack
           #   Timestamp of the message to add unfurl behavior to.
           # @option options [string] :unfurls
           #   URL-encoded JSON map with keys set to URLs featured in the the message, pointing to their unfurl blocks or message attachments.
-          # @option options [string] :source
+          # @option options [enum] :source
           #   The source of the link to unfurl. The source may either be composer, when the link is inside the message composer, or conversations_history, when the link has been posted to a conversation.
           # @option options [string] :unfurl_id
           #   The ID of the link to unfurl. Both unfurl_id and source must be provided together, or channel and ts must be provided together.
@@ -251,12 +251,14 @@ module Slack
           #   Channel containing the message to be updated.
           # @option options [timestamp] :ts
           #   Timestamp of the message to be updated.
-          # @option options [boolean] :as_user
-          #   Pass true to update the message as the authed user. Bot users in this context are considered authed users.
           # @option options [string] :attachments
-          #   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.
+          #   A JSON-based array of structured attachments, presented as a URL-encoded string.
           # @option options [blocks[] as string] :blocks
-          #   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.
+          #   A JSON-based array of structured blocks, presented as a URL-encoded string.
+          # @option options [string] :text
+          #   How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.
+          # @option options [boolean] :as_user
+          #   Pass true to update the message as the authed user. Bot users in this context are considered authed users.
           # @option options [array] :file_ids
           #   Array of new file ids that will be sent with this message.
           # @option options [boolean] :link_names
@@ -267,14 +269,12 @@ module Slack
           #   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.
           # @option options [boolean] :reply_broadcast
           #   Broadcast an existing thread reply to make it visible to everyone in the channel or conversation.
-          # @option options [string] :text
-          #   New text for the message, using the default formatting rules. It's not required when presenting blocks or attachments.
           # @see https://api.slack.com/methods/chat.update
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.update.json
           def chat_update(options = {})
             raise ArgumentError, 'Required arguments :channel missing' if options[:channel].nil?
             raise ArgumentError, 'Required arguments :ts missing' if options[:ts].nil?
-            raise ArgumentError, 'At least one of :attachments, :blocks, :text, :reply_broadcast is required' if options[:attachments].nil? && options[:blocks].nil? && options[:text].nil? && options[:reply_broadcast].nil?
+            raise ArgumentError, 'At least one of :attachments, :blocks, :text is required' if options[:attachments].nil? && options[:blocks].nil? && options[:text].nil?
             options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
             options = encode_options_as_json(options, %i[attachments blocks metadata])
             post('chat.update', options)

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

@@ -153,6 +153,8 @@ module Slack
           #   The ID of the public or private channel to invite user(s) to.
           # @option options [string] :users
           #   A comma separated list of user IDs. Up to 1000 users may be listed.
+          # @option options [boolean] :force
+          #   When set to true and multiple user IDs are provided, continue inviting the valid ones while disregarding invalid IDs. Defaults to false.
           # @see https://api.slack.com/methods/conversations.invite
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/conversations/conversations.invite.json
           def conversations_invite(options = {})
@@ -232,7 +234,7 @@ module Slack
           # @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 no larger than 1000.
+          #   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 under 1000.
           # @option options [string] :team_id
           #   encoded team id to list channels in, required if token belongs to org-wide app.
           # @option options [string] :types

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

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module Functions
+          #
+          # Signal that a function failed to complete
+          #
+          # @option options [string] :error
+          #   A human-readable error message that contains information about why the function failed to complete.
+          # @option options [string] :function_execution_id
+          #   Context identifier that maps to the executed function.
+          # @see https://api.slack.com/methods/functions.completeError
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/functions/functions.completeError.json
+          def functions_completeError(options = {})
+            raise ArgumentError, 'Required arguments :error missing' if options[:error].nil?
+            raise ArgumentError, 'Required arguments :function_execution_id missing' if options[:function_execution_id].nil?
+            post('functions.completeError', options)
+          end
+
+          #
+          # Signal the successful completion of a function
+          #
+          # @option options [string] :function_execution_id
+          #   Context identifier that maps to the executed function.
+          # @option options [object] :outputs
+          #   A JSON-based object that conforms to the output parameters schema for the custom function defined in the manifest.
+          # @see https://api.slack.com/methods/functions.completeSuccess
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/functions/functions.completeSuccess.json
+          def functions_completeSuccess(options = {})
+            raise ArgumentError, 'Required arguments :function_execution_id missing' if options[:function_execution_id].nil?
+            raise ArgumentError, 'Required arguments :outputs missing' if options[:outputs].nil?
+            options = encode_options_as_json(options, %i[outputs])
+            post('functions.completeSuccess', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -15,7 +15,7 @@ module Slack
           #   Issued when you created your application.
           # @option options [string] :code
           #   The code param returned via the OAuth callback.
-          # @option options [string] :grant_type
+          # @option options [enum] :grant_type
           #   The grant_type param as described in the OAuth spec.
           # @option options [string] :redirect_uri
           #   This must match the originally submitted URI (if one was sent).

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

@@ -11,8 +11,6 @@ module Slack
           #
           # @option options [channel] :channel
           #   Channel to pin the messsage to. You must also include a timestamp when pinning messages.
-          # @option options [string] :quip_component_id
-          #   Component ID for the pins component that was inserted into the channel canvas, if any.
           # @option options [string] :timestamp
           #   Timestamp of the message to pin. You must also include the channel.
           # @see https://api.slack.com/methods/pins.add

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

@@ -15,7 +15,7 @@ module Slack
           #   Pass a value of true to enable query highlight markers (see below).
           # @option options [string] :sort
           #   Return matches sorted by either score or timestamp.
-          # @option options [string] :sort_dir
+          # @option options [enum] :sort_dir
           #   Change sort direction to ascending (asc) or descending (desc).
           # @option options [string] :team_id
           #   encoded team id to search in, required if org token is used.
@@ -35,7 +35,7 @@ module Slack
           #   Pass a value of true to enable query highlight markers (see below).
           # @option options [string] :sort
           #   Return matches sorted by either score or timestamp.
-          # @option options [string] :sort_dir
+          # @option options [enum] :sort_dir
           #   Change sort direction to ascending (asc) or descending (desc).
           # @option options [string] :team_id
           #   encoded team id to search in, required if org token is used.
@@ -57,7 +57,7 @@ module Slack
           #   Pass a value of true to enable query highlight markers (see below).
           # @option options [string] :sort
           #   Return matches sorted by either score or timestamp.
-          # @option options [string] :sort_dir
+          # @option options [enum] :sort_dir
           #   Change sort direction to ascending (asc) or descending (desc).
           # @option options [string] :team_id
           #   encoded team id to search in, required if org token is used.

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

@@ -57,7 +57,7 @@ module Slack
           # 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.
+          #   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
@@ -71,8 +71,8 @@ module Slack
           #
           # @option options [string] :app_id
           #   Filter logs to this Slack app. Defaults to all logs.
-          # @option options [string] :change_type
-          #   Filter logs with this change type. Defaults to all logs.
+          # @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

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

@@ -9,7 +9,7 @@ module Slack
           #
           # Retrieve a team's profile.
           #
-          # @option options [string] :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/usergroups.rb

@@ -7,7 +7,7 @@ module Slack
       module Endpoints
         module Usergroups
           #
-          # Create a User Group
+          # Create a User Group.
           #
           # @option options [string] :name
           #   A name for the User Group. Must be unique among User Groups.
@@ -29,7 +29,7 @@ module Slack
           end
 
           #
-          # Disable an existing User Group
+          # Disable an existing User Group.
           #
           # @option options [Object] :usergroup
           #   The encoded ID of the User Group to disable.
@@ -45,7 +45,7 @@ module Slack
           end
 
           #
-          # Enable a User Group
+          # Enable a User Group.
           #
           # @option options [string] :usergroup
           #   The encoded ID of the User Group to enable.
@@ -61,7 +61,7 @@ module Slack
           end
 
           #
-          # List all User Groups for a team
+          # List all User Groups for a team.
           #
           # @option options [boolean] :include_count
           #   Include the number of users in each User Group.
@@ -78,7 +78,7 @@ 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.

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

@@ -7,10 +7,10 @@ module Slack
       module Endpoints
         module UsergroupsUsers
           #
-          # List all users in a User Group
+          # List all users in a User Group.
           #
           # @option options [string] :usergroup
-          #   The encoded ID of the User Group to update.
+          #   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
@@ -23,14 +23,14 @@ module Slack
           end
 
           #
-          # Update the list of users for a User Group
+          # Update the list of users for a user group.
           #
           # @option options [string] :usergroup
-          #   The encoded ID of the User Group to update.
+          #   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.
+          #   A comma separated string of encoded user IDs that represent the entire list of users for the user group.
           # @option options [boolean] :include_count
-          #   Include the number of users in the User Group.
+          #   Include the number of users in the user group.
           # @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

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

@@ -143,7 +143,7 @@ module Slack
           #
           # Manually sets user presence.
           #
-          # @option options [string] :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

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

@@ -55,6 +55,7 @@ require_relative 'endpoints/emoji'
 require_relative 'endpoints/files'
 require_relative 'endpoints/files_comments'
 require_relative 'endpoints/files_remote'
+require_relative 'endpoints/functions'
 require_relative 'endpoints/functions_workflows_steps'
 require_relative 'endpoints/functions_workflows_steps_responses'
 require_relative 'endpoints/migration'
@@ -142,6 +143,7 @@ module Slack
         include Files
         include FilesComments
         include FilesRemote
+        include Functions
         include FunctionsWorkflowsSteps
         include FunctionsWorkflowsStepsResponses
         include Migration

data/lib/slack/web/api/errors.rb

@@ -32,6 +32,7 @@ module Slack
         class ApprovalNotFound < SlackError; end
         class AsUserNotSupported < SlackError; end
         class AtLeastOneSessionSettingRequired < SlackError; end
+        class AttachmentPayloadLimitExceeded < SlackError; end
         class AuthMismatch < SlackError; end
         class AuthorizationNotFound < SlackError; end
         class AutoProvisionFailure < SlackError; end
@@ -174,6 +175,7 @@ module Slack
         class ErrorTooBig < SlackError; end
         class ErrorUnpublishingWorkflows < SlackError; end
         class ExchangedTriggerId < SlackError; end
+        class ExecutionNotInRunningState < SlackError; end
         class ExpiredTriggerId < SlackError; end
         class ExternalChannelMigrating < SlackError; end
         class ExternalLimitedRestriction < SlackError; end
@@ -231,6 +233,7 @@ module Slack
         class ForbiddenHandle < SlackError; end
         class ForbiddenTeam < SlackError; end
         class FreeTeamNotAllowed < SlackError; end
+        class FunctionExecutionNotFound < SlackError; end
         class FunctionNotFound < SlackError; end
         class GroupAlreadyLinkedToChannel < SlackError; end
         class GroupMustNotBeEmpty < SlackError; end
@@ -240,6 +243,7 @@ module Slack
         class HashConflict < SlackError; end
         class InactiveCall < SlackError; end
         class InactiveInvite < SlackError; end
+        class IncludeDeactivatedUserWorkspacesInvalid < SlackError; end
         class InsecureRequest < SlackError; end
         class InternalError < SlackError; end
         class InvalidAction < SlackError; end
@@ -384,11 +388,13 @@ module Slack
         class MissingChannel < SlackError; end
         class MissingDialog < SlackError; end
         class MissingDuration < SlackError; end
+        class MissingFileData < SlackError; end
         class MissingPostType < SlackError; end
         class MissingProfileId < SlackError; end
         class MissingResource < SlackError; end
         class MissingScope < SlackError; end
         class MissingSource < SlackError; end
+        class MissingStepIds < SlackError; end
         class MissingSubteamName < SlackError; end
         class MissingTargetTeam < SlackError; end
         class MissingTeam < SlackError; end
@@ -472,6 +478,7 @@ module Slack
         class PaginationNotAvailable < SlackError; end
         class PaidOnly < SlackError; end
         class PaidTeamsOnly < SlackError; end
+        class ParameterValidationFailed < SlackError; end
         class ParentBookmarkDisabled < SlackError; end
         class ParentWithLink < SlackError; end
         class PartialProfileSetFailed < SlackError; end
@@ -647,6 +654,7 @@ module Slack
           'approval_not_found' => ApprovalNotFound,
           'as_user_not_supported' => AsUserNotSupported,
           'at_least_one_session_setting_required' => AtLeastOneSessionSettingRequired,
+          'attachment_payload_limit_exceeded' => AttachmentPayloadLimitExceeded,
           'auth_mismatch' => AuthMismatch,
           'authorization_not_found' => AuthorizationNotFound,
           'auto_provision_failure' => AutoProvisionFailure,
@@ -789,6 +797,7 @@ module Slack
           'error_too_big' => ErrorTooBig,
           'error_unpublishing_workflows' => ErrorUnpublishingWorkflows,
           'exchanged_trigger_id' => ExchangedTriggerId,
+          'execution_not_in_running_state' => ExecutionNotInRunningState,
           'expired_trigger_id' => ExpiredTriggerId,
           'external_channel_migrating' => ExternalChannelMigrating,
           'external_limited_restriction' => ExternalLimitedRestriction,
@@ -846,6 +855,7 @@ module Slack
           'forbidden_handle' => ForbiddenHandle,
           'forbidden_team' => ForbiddenTeam,
           'free_team_not_allowed' => FreeTeamNotAllowed,
+          'function_execution_not_found' => FunctionExecutionNotFound,
           'function_not_found' => FunctionNotFound,
           'group_already_linked_to_channel' => GroupAlreadyLinkedToChannel,
           'group_must_not_be_empty' => GroupMustNotBeEmpty,
@@ -855,6 +865,7 @@ module Slack
           'hash_conflict' => HashConflict,
           'inactive_call' => InactiveCall,
           'inactive_invite' => InactiveInvite,
+          'include_deactivated_user_workspaces_invalid' => IncludeDeactivatedUserWorkspacesInvalid,
           'insecure_request' => InsecureRequest,
           'internal_error' => InternalError,
           'invalid_action' => InvalidAction,
@@ -999,11 +1010,13 @@ module Slack
           'missing_channel' => MissingChannel,
           'missing_dialog' => MissingDialog,
           'missing_duration' => MissingDuration,
+          'missing_file_data' => MissingFileData,
           'missing_post_type' => MissingPostType,
           'missing_profile_id' => MissingProfileId,
           'missing_resource' => MissingResource,
           'missing_scope' => MissingScope,
           'missing_source' => MissingSource,
+          'missing_step_ids' => MissingStepIds,
           'missing_subteam_name' => MissingSubteamName,
           'missing_target_team' => MissingTargetTeam,
           'missing_team' => MissingTeam,
@@ -1087,6 +1100,7 @@ module Slack
           'pagination_not_available' => PaginationNotAvailable,
           'paid_only' => PaidOnly,
           'paid_teams_only' => PaidTeamsOnly,
+          'parameter_validation_failed' => ParameterValidationFailed,
           'parent_bookmark_disabled' => ParentBookmarkDisabled,
           'parent_with_link' => ParentWithLink,
           'partial_profile_set_failed' => PartialProfileSetFailed,

data/spec/slack/events/request_spec.rb

@@ -47,6 +47,17 @@ RSpec.describe Slack::Events::Request do
     expect(http_request.body.read).to eq body
   end
 
+  context 'with an already read body' do
+    before do
+      http_request.body.read
+    end
+
+    it 'rewinds the request body before reading it' do
+      expect(request.body).to eq body
+      expect(http_request.body.read).to eq body
+    end
+  end
+
   context 'time' do
     after do
       Timecop.return

data/spec/slack/web/api/endpoints/chat_spec.rb

@@ -6,9 +6,33 @@ require 'spec_helper'
 RSpec.describe Slack::Web::Api::Endpoints::Chat do
   let(:client) { Slack::Web::Client.new }
   context 'chat_postEphemeral' do
+    it 'requires one of attachments, blocks, text' do
+      expect { client.chat_postEphemeral(channel: %q[C1234567890], user: %q[U0BPQUNTA]) }.to raise_error ArgumentError, /At least one of/
+
+      expect(client).to receive(:post).with('chat.postEphemeral', {attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], channel: %q[C1234567890], user: %q[U0BPQUNTA]})
+      client.chat_postEphemeral(attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], channel: %q[C1234567890], user: %q[U0BPQUNTA])
+
+      expect(client).to receive(:post).with('chat.postEphemeral', {blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], channel: %q[C1234567890], user: %q[U0BPQUNTA]})
+      client.chat_postEphemeral(blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], channel: %q[C1234567890], user: %q[U0BPQUNTA])
+
+      expect(client).to receive(:post).with('chat.postEphemeral', {text: %q[Hello world], channel: %q[C1234567890], user: %q[U0BPQUNTA]})
+      client.chat_postEphemeral(text: %q[Hello world], channel: %q[C1234567890], user: %q[U0BPQUNTA])
+
+      expect(client).to receive(:post).with('chat.postEphemeral', {attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], channel: %q[C1234567890], user: %q[U0BPQUNTA]})
+      client.chat_postEphemeral(attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], channel: %q[C1234567890], user: %q[U0BPQUNTA])
+
+      expect(client).to receive(:post).with('chat.postEphemeral', {attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], text: %q[Hello world], channel: %q[C1234567890], user: %q[U0BPQUNTA]})
+      client.chat_postEphemeral(attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], text: %q[Hello world], channel: %q[C1234567890], user: %q[U0BPQUNTA])
+
+      expect(client).to receive(:post).with('chat.postEphemeral', {blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], text: %q[Hello world], channel: %q[C1234567890], user: %q[U0BPQUNTA]})
+      client.chat_postEphemeral(blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], text: %q[Hello world], channel: %q[C1234567890], user: %q[U0BPQUNTA])
+
+      expect(client).to receive(:post).with('chat.postEphemeral', {attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], text: %q[Hello world], channel: %q[C1234567890], user: %q[U0BPQUNTA]})
+      client.chat_postEphemeral(attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], text: %q[Hello world], channel: %q[C1234567890], user: %q[U0BPQUNTA])
+    end
     it 'encodes attachments, blocks as json' do
-      expect(client).to receive(:post).with('chat.postEphemeral', {channel: %q[C1234567890], text: %q[Hello world], user: %q[U0BPQUNTA], attachments: %q[{"data":["data"]}], blocks: %q[{"data":["data"]}]})
-      client.chat_postEphemeral(channel: %q[C1234567890], text: %q[Hello world], user: %q[U0BPQUNTA], attachments: {:data=>["data"]}, blocks: {:data=>["data"]})
+      expect(client).to receive(:post).with('chat.postEphemeral', {channel: %q[C1234567890], user: %q[U0BPQUNTA], attachments: %q[{"data":["data"]}], blocks: %q[{"data":["data"]}]})
+      client.chat_postEphemeral(channel: %q[C1234567890], user: %q[U0BPQUNTA], attachments: {:data=>["data"]}, blocks: {:data=>["data"]})
     end
   end
   context 'chat_postMessage' do
@@ -42,9 +66,33 @@ RSpec.describe Slack::Web::Api::Endpoints::Chat do
     end
   end
   context 'chat_scheduleMessage' do
+    it 'requires one of attachments, blocks, text' do
+      expect { client.chat_scheduleMessage(channel: %q[C1234567890], post_at: %q[299876400]) }.to raise_error ArgumentError, /At least one of/
+
+      expect(client).to receive(:post).with('chat.scheduleMessage', {attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], channel: %q[C1234567890], post_at: %q[299876400]})
+      client.chat_scheduleMessage(attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], channel: %q[C1234567890], post_at: %q[299876400])
+
+      expect(client).to receive(:post).with('chat.scheduleMessage', {blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], channel: %q[C1234567890], post_at: %q[299876400]})
+      client.chat_scheduleMessage(blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], channel: %q[C1234567890], post_at: %q[299876400])
+
+      expect(client).to receive(:post).with('chat.scheduleMessage', {text: %q[Hello world], channel: %q[C1234567890], post_at: %q[299876400]})
+      client.chat_scheduleMessage(text: %q[Hello world], channel: %q[C1234567890], post_at: %q[299876400])
+
+      expect(client).to receive(:post).with('chat.scheduleMessage', {attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], channel: %q[C1234567890], post_at: %q[299876400]})
+      client.chat_scheduleMessage(attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], channel: %q[C1234567890], post_at: %q[299876400])
+
+      expect(client).to receive(:post).with('chat.scheduleMessage', {attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], text: %q[Hello world], channel: %q[C1234567890], post_at: %q[299876400]})
+      client.chat_scheduleMessage(attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], text: %q[Hello world], channel: %q[C1234567890], post_at: %q[299876400])
+
+      expect(client).to receive(:post).with('chat.scheduleMessage', {blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], text: %q[Hello world], channel: %q[C1234567890], post_at: %q[299876400]})
+      client.chat_scheduleMessage(blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], text: %q[Hello world], channel: %q[C1234567890], post_at: %q[299876400])
+
+      expect(client).to receive(:post).with('chat.scheduleMessage', {attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], text: %q[Hello world], channel: %q[C1234567890], post_at: %q[299876400]})
+      client.chat_scheduleMessage(attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], text: %q[Hello world], channel: %q[C1234567890], post_at: %q[299876400])
+    end
     it 'encodes attachments, blocks, metadata as json' do
-      expect(client).to receive(:post).with('chat.scheduleMessage', {channel: %q[C1234567890], post_at: %q[299876400], text: %q[Hello world], attachments: %q[{"data":["data"]}], blocks: %q[{"data":["data"]}], metadata: %q[{"data":["data"]}]})
-      client.chat_scheduleMessage(channel: %q[C1234567890], post_at: %q[299876400], text: %q[Hello world], attachments: {:data=>["data"]}, blocks: {:data=>["data"]}, metadata: {:data=>["data"]})
+      expect(client).to receive(:post).with('chat.scheduleMessage', {channel: %q[C1234567890], post_at: %q[299876400], attachments: %q[{"data":["data"]}], blocks: %q[{"data":["data"]}], metadata: %q[{"data":["data"]}]})
+      client.chat_scheduleMessage(channel: %q[C1234567890], post_at: %q[299876400], attachments: {:data=>["data"]}, blocks: {:data=>["data"]}, metadata: {:data=>["data"]})
     end
   end
   context 'chat_unfurl' do
@@ -54,6 +102,30 @@ RSpec.describe Slack::Web::Api::Endpoints::Chat do
     end
   end
   context 'chat_update' do
+    it 'requires one of attachments, blocks, text' do
+      expect { client.chat_update(channel: %q[C1234567890], ts: %q["1405894322.002768"]) }.to raise_error ArgumentError, /At least one of/
+
+      expect(client).to receive(:post).with('chat.update', {attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], channel: %q[C1234567890], ts: %q["1405894322.002768"]})
+      client.chat_update(attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], channel: %q[C1234567890], ts: %q["1405894322.002768"])
+
+      expect(client).to receive(:post).with('chat.update', {blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], channel: %q[C1234567890], ts: %q["1405894322.002768"]})
+      client.chat_update(blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], channel: %q[C1234567890], ts: %q["1405894322.002768"])
+
+      expect(client).to receive(:post).with('chat.update', {text: %q[Hello world], channel: %q[C1234567890], ts: %q["1405894322.002768"]})
+      client.chat_update(text: %q[Hello world], channel: %q[C1234567890], ts: %q["1405894322.002768"])
+
+      expect(client).to receive(:post).with('chat.update', {attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], channel: %q[C1234567890], ts: %q["1405894322.002768"]})
+      client.chat_update(attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], channel: %q[C1234567890], ts: %q["1405894322.002768"])
+
+      expect(client).to receive(:post).with('chat.update', {attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], text: %q[Hello world], channel: %q[C1234567890], ts: %q["1405894322.002768"]})
+      client.chat_update(attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], text: %q[Hello world], channel: %q[C1234567890], ts: %q["1405894322.002768"])
+
+      expect(client).to receive(:post).with('chat.update', {blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], text: %q[Hello world], channel: %q[C1234567890], ts: %q["1405894322.002768"]})
+      client.chat_update(blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], text: %q[Hello world], channel: %q[C1234567890], ts: %q["1405894322.002768"])
+
+      expect(client).to receive(:post).with('chat.update', {attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], text: %q[Hello world], channel: %q[C1234567890], ts: %q["1405894322.002768"]})
+      client.chat_update(attachments: %q[[{"pretext": "pre-hello", "text": "text-world"}]], blocks: %q[[{"type": "section", "text": {"type": "plain_text", "text": "Hello world"}}]], text: %q[Hello world], channel: %q[C1234567890], ts: %q["1405894322.002768"])
+    end
     it 'encodes attachments, blocks, metadata as json' do
       expect(client).to receive(:post).with('chat.update', {channel: %q[C1234567890], ts: %q["1405894322.002768"], attachments: %q[{"data":["data"]}], blocks: %q[{"data":["data"]}], metadata: %q[{"data":["data"]}]})
       client.chat_update(channel: %q[C1234567890], ts: %q["1405894322.002768"], attachments: {:data=>["data"]}, blocks: {:data=>["data"]}, metadata: {:data=>["data"]})