Update API from slack-api-ref@bd5dd34 (2025-09-29)

web-flow · web-flow · commit ba5ec951aff4 · 2025-09-29T23:22:50.000Z
diff --git a/bin/commands/admin_functions.rb b/bin/commands/admin_functions.rb
@@ -6,11 +6,12 @@ module Cli
     class App
       desc 'AdminFunctions methods.'
       command 'admin_functions' do |g|
-        g.desc 'Look up functions by a set of apps'
-        g.long_desc %( Look up functions by a set of apps )
+        g.desc 'Look up functions by a set of apps.'
+        g.long_desc %( Look up functions by a set of apps. )
         g.command 'list' do |c|
           c.flag 'team_id', desc: 'The team context to retrieve functions from.'
           c.flag 'app_ids', desc: 'Comma-separated array of app IDs to get functions for; max 50.'
+          c.flag 'include_non_distributed_functions', desc: 'Whether to also include functions that are not yet distributed to any users in the function count. This is needed for admins that are approving an app request and will only work if the team owns the app.'
           c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
           c.flag 'limit', desc: 'The number of results that will be returned by the API on each invocation. Must be between 1 and 1000, both inclusive.'
           c.action do |_global_options, options, _args|
diff --git a/bin/commands/admin_functions_permissions.rb b/bin/commands/admin_functions_permissions.rb
@@ -15,8 +15,8 @@ class App
           end
         end
 
-        g.desc 'Set the visibility of a Slack function and define the users or workspaces if it is set to named_entities'
-        g.long_desc %( Set the visibility of a Slack function and define the users or workspaces if it is set to named_entities )
+        g.desc 'Set the visibility of a Slack function and define the users or workspaces if it is set to named_entities.'
+        g.long_desc %( Set the visibility of a Slack function and define the users or workspaces if it is set to named_entities. )
         g.command 'set' do |c|
           c.flag 'function_id', desc: 'The function ID to set permissions for.'
           c.flag 'visibility', desc: 'The function visibility.'
diff --git a/bin/commands/assistant_search.rb b/bin/commands/assistant_search.rb
@@ -13,18 +13,19 @@ class App
           c.flag 'action_token', desc: 'Send action_token as received in a message event.'
           c.flag 'channel_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 'content_types', desc: 'Content types to include, a comma-separated list of any combination of messages, files, channels, users.'
-          c.flag 'include_bots', desc: 'If you want the results to include bots.'
+          c.flag 'include_bots', desc: 'Whether the results should include bots.'
           c.flag 'before', desc: 'UNIX timestamp filter. If present, filters for results before this date.'
           c.flag 'after', desc: 'UNIX timestamp filter. If present, filters for results after this date.'
           c.flag 'include_context_messages', desc: 'Whether to include context messages surrounding the main message result. Defaults to false if unspecified.'
           c.flag 'context_channel_id', desc: 'Context channel ID to support scoping the search when applicable.'
-          c.flag 'cursor', desc: 'The cursor returned by the API. Leave this blank for the first request, and use this to get the next page of results.'
+          c.flag 'cursor', desc: 'The cursor returned by the API. Leave this blank for the first request and use this to get the next page of results.'
           c.flag 'limit', desc: 'Number of results to return, up to a max of 20. Defaults to 20.'
           c.flag 'sort', desc: 'The field to sort the results by. Defaults to score. Can be one of: score, timestamp.'
           c.flag 'sort_dir', desc: 'The direction to sort the results by. Defaults to desc.'
           c.flag 'include_message_blocks', desc: 'Whether to return the message blocks in the response.'
           c.flag 'highlight', desc: 'Whether to highlight the search query in the results. Defaults to false if unspecified.'
-          c.flag 'term_clauses', desc: 'A list of term clauses. A term clause is a string with search terms. Search results returned will match every term clause specified (i.e. conjunctive normal form).'
+          c.flag 'term_clauses', desc: 'A list of term clauses. A term clause is a string with search terms. Search results returned will match every term clause specified (i.e., conjunctive normal form).'
+          c.flag 'modifiers', desc: 'A string containing only modifiers in the format of modifier:value. Search results returned will match the modifier value. For now modifiers only affect term clauses.'
           c.action do |_global_options, options, _args|
             puts JSON.dump(@client.assistant_search_context(options))
           end
diff --git a/bin/commands/chat.rb b/bin/commands/chat.rb
@@ -87,6 +87,7 @@ class App
           c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
           c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
           c.flag 'channel', desc: 'An encoded ID or channel name that represents a channel, private group, or IM channel to send the message to. See below for more details.'
+          c.flag 'current_draft_last_updated_ts', desc: "This field represents the timestamp of the draft's last update at the time this API is called. If the current message is a draft, this field can be provided to ensure synchronization with the server."
           c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url.'
           c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message.'
           c.flag 'link_names', desc: 'Find and link user groups. No longer supports linking individual users; use syntax shown in Mentioning Users instead.'
diff --git a/bin/commands/oauth_v2.rb b/bin/commands/oauth_v2.rb
@@ -12,6 +12,7 @@ class App
           c.flag 'client_id', desc: 'Issued when you created your application. If possible, avoid sending client_id and client_secret as parameters in your request and instead supply the Client ID and Client Secret using the HTTP Basic authentication scheme.'
           c.flag 'client_secret', desc: 'Issued when you created your application. If possible, avoid sending client_id and client_secret as parameters in your request and instead supply the Client ID and Client Secret using the HTTP Basic authentication scheme.'
           c.flag 'code', desc: 'The code param returned via the OAuth callback.'
+          c.flag 'code_verifier', desc: 'The code_verifier param used to generate the code_challenge originally. Used for PKCE.'
           c.flag 'redirect_uri', desc: 'This must match the originally submitted URI (if one was sent).'
           c.flag 'grant_type', desc: 'The grant_type param as described in the OAuth spec.'
           c.flag 'refresh_token', desc: 'The refresh_token param as described in the OAuth spec.'
diff --git a/lib/slack/web/api/endpoints/admin_functions.rb b/lib/slack/web/api/endpoints/admin_functions.rb
@@ -7,12 +7,14 @@ module Api
       module Endpoints
         module AdminFunctions
           #
-          # Look up functions by a set of apps
+          # Look up functions by a set of apps.
           #
           # @option options [Object] :team_id
           #   The team context to retrieve functions from.
           # @option options [array] :app_ids
           #   Comma-separated array of app IDs to get functions for; max 50.
+          # @option options [boolean] :include_non_distributed_functions
+          #   Whether to also include functions that are not yet distributed to any users in the function count. This is needed for admins that are approving an app request and will only work if the team owns the app.
           # @option options [string] :cursor
           #   Set cursor to next_cursor returned by the previous call to list items in the next page.
           # @option options [integer] :limit
diff --git a/lib/slack/web/api/endpoints/admin_functions_permissions.rb b/lib/slack/web/api/endpoints/admin_functions_permissions.rb
@@ -19,7 +19,7 @@ def admin_functions_permissions_lookup(options = {})
           end
 
           #
-          # Set the visibility of a Slack function and define the users or workspaces if it is set to named_entities
+          # Set the visibility of a Slack function and define the users or workspaces if it is set to named_entities.
           #
           # @option options [string] :function_id
           #   The function ID to set permissions for.
diff --git a/lib/slack/web/api/endpoints/assistant_search.rb b/lib/slack/web/api/endpoints/assistant_search.rb
@@ -18,7 +18,7 @@ module AssistantSearch
           # @option options [array] :content_types
           #   Content types to include, a comma-separated list of any combination of messages, files, channels, users.
           # @option options [boolean] :include_bots
-          #   If you want the results to include bots.
+          #   Whether the results should include bots.
           # @option options [integer] :before
           #   UNIX timestamp filter. If present, filters for results before this date.
           # @option options [integer] :after
@@ -28,7 +28,7 @@ module AssistantSearch
           # @option options [Object] :context_channel_id
           #   Context channel ID to support scoping the search when applicable.
           # @option options [string] :cursor
-          #   The cursor returned by the API. Leave this blank for the first request, and use this to get the next page of results.
+          #   The cursor returned by the API. Leave this blank for the first request and use this to get the next page of results.
           # @option options [integer] :limit
           #   Number of results to return, up to a max of 20. Defaults to 20.
           # @option options [enum] :sort
@@ -40,7 +40,9 @@ module AssistantSearch
           # @option options [boolean] :highlight
           #   Whether to highlight the search query in the results. Defaults to false if unspecified.
           # @option options [array] :term_clauses
-          #   A list of term clauses. A term clause is a string with search terms. Search results returned will match every term clause specified (i.e. conjunctive normal form).
+          #   A list of term clauses. A term clause is a string with search terms. Search results returned will match every term clause specified (i.e., conjunctive normal form).
+          # @option options [string] :modifiers
+          #   A string containing only modifiers in the format of modifier:value. Search results returned will match the modifier value. For now modifiers only affect term clauses.
           # @see https://api.slack.com/methods/assistant.search.context
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/assistant.search/assistant.search.context.json
           def assistant_search_context(options = {})
diff --git a/lib/slack/web/api/endpoints/chat.rb b/lib/slack/web/api/endpoints/chat.rb
@@ -142,6 +142,8 @@ def chat_postEphemeral(options = {})
           #   A JSON-based array of structured blocks, presented as a URL-encoded string.
           # @option options [channel] :channel
           #   An encoded ID or channel name that represents a channel, private group, or IM channel to send the message to. See below for more details.
+          # @option options [string] :current_draft_last_updated_ts
+          #   This field represents the timestamp of the draft's last update at the time this API is called. If the current message is a draft, this field can be provided to ensure synchronization with the server.
           # @option options [string] :icon_emoji
           #   Emoji to use as the icon for this message. Overrides icon_url.
           # @option options [string] :icon_url
diff --git a/lib/slack/web/api/endpoints/oauth_v2.rb b/lib/slack/web/api/endpoints/oauth_v2.rb
@@ -15,6 +15,8 @@ module OauthV2
           #   Issued when you created your application. If possible, avoid sending client_id and client_secret as parameters in your request and instead supply the Client ID and Client Secret using the HTTP Basic authentication scheme.
           # @option options [string] :code
           #   The code param returned via the OAuth callback.
+          # @option options [string] :code_verifier
+          #   The code_verifier param used to generate the code_challenge originally. Used for PKCE.
           # @option options [string] :redirect_uri
           #   This must match the originally submitted URI (if one was sent).
           # @option options [string] :grant_type
diff --git a/lib/slack/web/api/errors.rb b/lib/slack/web/api/errors.rb
@@ -31,6 +31,7 @@ class ApprovalInactive < SlackError; end
         class ApprovalNotFound < SlackError; end
         class ArchiveNotSupported < SlackError; end
         class AsUserNotSupported < SlackError; end
+        class AssistantSearchContextDisabled < SlackError; end
         class AtLeastOneSessionSettingRequired < SlackError; end
         class AttachmentPayloadLimitExceeded < SlackError; end
         class AuthMismatch < SlackError; end
@@ -169,6 +170,10 @@ class DeleteNotAllowed < SlackError; end
         class DescriptionTooLong < SlackError; end
         class DiscoverabilitySettingInvalid < SlackError; end
         class DomainTaken < SlackError; end
+        class DraftAlreadyDeleted < SlackError; end
+        class DraftAlreadySent < SlackError; end
+        class DraftHasConflict < SlackError; end
+        class DraftNotFound < SlackError; end
         class DuplicateChannelNotFound < SlackError; end
         class DuplicateExternalId < SlackError; end
         class DuplicateMessageNotFound < SlackError; end
@@ -305,6 +310,7 @@ class InvalidChannelsLimit < SlackError; end
         class InvalidChildType < SlackError; end
         class InvalidClientId < SlackError; end
         class InvalidCode < SlackError; end
+        class InvalidCodeVerifier < SlackError; end
         class InvalidColumnId < SlackError; end
         class InvalidColumnType < SlackError; end
         class InvalidCopyAndSchemaArgs < SlackError; end
@@ -560,6 +566,7 @@ class PartialFailure < SlackError; end
         class PartialProfileSetFailed < SlackError; end
         class PermissionDenied < SlackError; end
         class PermissionTypeRequired < SlackError; end
+        class PkceNotAllowed < SlackError; end
         class PlanUpgradeRequired < SlackError; end
         class PolicyNotFound < SlackError; end
         class PostContentsTooLarge < SlackError; end
@@ -745,6 +752,7 @@ class WorkflowsExportCsvNotEnabled < SlackError; end
           'approval_not_found' => ApprovalNotFound,
           'archive_not_supported' => ArchiveNotSupported,
           'as_user_not_supported' => AsUserNotSupported,
+          'assistant_search_context_disabled' => AssistantSearchContextDisabled,
           'at_least_one_session_setting_required' => AtLeastOneSessionSettingRequired,
           'attachment_payload_limit_exceeded' => AttachmentPayloadLimitExceeded,
           'auth_mismatch' => AuthMismatch,
@@ -883,6 +891,10 @@ class WorkflowsExportCsvNotEnabled < SlackError; end
           'description_too_long' => DescriptionTooLong,
           'discoverability_setting_invalid' => DiscoverabilitySettingInvalid,
           'domain_taken' => DomainTaken,
+          'draft_already_deleted' => DraftAlreadyDeleted,
+          'draft_already_sent' => DraftAlreadySent,
+          'draft_has_conflict' => DraftHasConflict,
+          'draft_not_found' => DraftNotFound,
           'duplicate_channel_not_found' => DuplicateChannelNotFound,
           'duplicate_external_id' => DuplicateExternalId,
           'duplicate_message_not_found' => DuplicateMessageNotFound,
@@ -1019,6 +1031,7 @@ class WorkflowsExportCsvNotEnabled < SlackError; end
           'invalid_child_type' => InvalidChildType,
           'invalid_client_id' => InvalidClientId,
           'invalid_code' => InvalidCode,
+          'invalid_code_verifier' => InvalidCodeVerifier,
           'invalid_column_id' => InvalidColumnId,
           'invalid_column_type' => InvalidColumnType,
           'invalid_copy_and_schema_args' => InvalidCopyAndSchemaArgs,
@@ -1274,6 +1287,7 @@ class WorkflowsExportCsvNotEnabled < SlackError; end
           'partial_profile_set_failed' => PartialProfileSetFailed,
           'permission_denied' => PermissionDenied,
           'permission_type_required' => PermissionTypeRequired,
+          'pkce_not_allowed' => PkceNotAllowed,
           'plan_upgrade_required' => PlanUpgradeRequired,
           'policy_not_found' => PolicyNotFound,
           'post_contents_too_large' => PostContentsTooLarge,
diff --git a/lib/slack/web/api/slack-api-ref b/lib/slack/web/api/slack-api-ref
@@ -1 +1 @@
-Subproject commit bd5dd34cc34916223f8616b6e709de691d5ea4cb
+Subproject commit fa54d209b049580f7920a19e4908dfa6a4ce2e98

Original file line number	Diff line number	Diff line change
`@@ -19,7 +19,7 @@ def admin_functions_permissions_lookup(options = {})`
`19`	`19`	`end`
`20`	`20`
`21`	`21`	`#`
`22`		`- # Set the visibility of a Slack function and define the users or workspaces if it is set to named_entities`
	`22`	`+ # Set the visibility of a Slack function and define the users or workspaces if it is set to named_entities.`
`23`	`23`	`#`
`24`	`24`	`# @option options [string] :function_id`
`25`	`25`	`# The function ID to set permissions for.`