You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 2a697df
Browse filesBrowse the repository at this point in the historyBrowse files
Update API from slack-api-ref@d980b88 (2026-09-28)
- Add channel_ids argument to admin.apps.permissions.add and admin.apps.permissions.remove, and channel_restriction_mode/channel_ids arguments to admin.apps.permissions.set
- Add oauth.v2.beginShortTokenRotation and oauth.v2.completeShortTokenRotation methods
- Add session_status argument to chat.stopStream
- Add include_list argument to slackLists.items.list
- Update chat.startStream and chat.stopStream chunks argument documentation to mention markdown text, task update, plan update, and blocks chunk objects
- Add new error codes including AgentPromptDisplayNotAllowed, ChannelRestrictionRequiresAppAccess, ChannelRestrictionsNotAvailable, RotationNotFound, TokenTooLong, TooManyChannels, UserIsExternalGuest, and UserNotAuthenticated
Copy file name to clipboardExpand all lines: CHANGELOG.md
+6Lines changed: 6 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,6 +17,12 @@
17
17
*[#597](https://github.com/slack-ruby/slack-ruby-client/pull/597): Add AgentsSessions and AppsManagedPermissions endpoint modules for agents.sessions and apps.managedPermissions methods - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
18
18
*[#597](https://github.com/slack-ruby/slack-ruby-client/pull/597): Increase conversations.invite users limit from 100 to 1000 - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
19
19
*[#597](https://github.com/slack-ruby/slack-ruby-client/pull/597): Add new Slack API error codes - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
20
+
*[#600](https://github.com/slack-ruby/slack-ruby-client/pull/600): Add channel_ids argument to admin.apps.permissions.add and admin.apps.permissions.remove, and channel_restriction_mode/channel_ids arguments to admin.apps.permissions.set - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
21
+
*[#600](https://github.com/slack-ruby/slack-ruby-client/pull/600): Add oauth.v2.beginShortTokenRotation and oauth.v2.completeShortTokenRotation methods - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
22
+
*[#600](https://github.com/slack-ruby/slack-ruby-client/pull/600): Add session_status argument to chat.stopStream - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
23
+
*[#600](https://github.com/slack-ruby/slack-ruby-client/pull/600): Add include_list argument to slackLists.items.list - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
24
+
*[#600](https://github.com/slack-ruby/slack-ruby-client/pull/600): Update chat.startStream and chat.stopStream chunks argument documentation to mention markdown text, task update, plan update, and blocks chunk objects - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
25
+
*[#600](https://github.com/slack-ruby/slack-ruby-client/pull/600): Add new error codes including AgentPromptDisplayNotAllowed, ChannelRestrictionRequiresAppAccess, ChannelRestrictionsNotAvailable, RotationNotFound, TokenTooLong, TooManyChannels, UserIsExternalGuest, and UserNotAuthenticated - [@slack-ruby-ci-bot](https://github.com/apps/slack-ruby-ci-bot).
Copy file name to clipboardExpand all lines: bin/commands/admin_apps_permissions.rb
+4Lines changed: 4 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -12,6 +12,7 @@ class App
12
12
c.flag'app_id',desc: 'Encoded ID of the app.'
13
13
c.flag'user_ids',desc: 'List of user IDs to allow for named_entities visibility.'
14
14
c.flag'usergroup_ids',desc: 'List of encoded usergroup IDs.'
15
+
c.flag'channel_ids',desc: "List of encoded channel IDs to add to the channel restriction list. Interpretation depends on the app's channel_restriction_mode, which is configured via the admin.apps.permissions.set method."
c.flag'user_ids',desc: 'List of user IDs whose named_entities access will be revoked.'
34
35
c.flag'usergroup_ids',desc: 'List of encoded usergroup IDs.'
36
+
c.flag'channel_ids',desc: "List of encoded channel IDs to remove from the channel restriction list. Interpretation depends on the app's channel_restriction_mode, which is configured via the admin.apps.permissions.set method."
c.flag'permission_type',desc: 'The type of permission that defines who can access the app.'
45
47
c.flag'user_ids',desc: 'List of user IDs to allow for named_entities visibility.'
46
48
c.flag'usergroup_ids',desc: 'List of encoded usergroup IDs.'
49
+
c.flag'channel_restriction_mode',desc: 'The mode that defines where the app can be used in channels.'
50
+
c.flag'channel_ids',desc: 'List of encoded channel IDs for channel restrictions. Semantics depend on channel_restriction_mode: allowlist for specific_channels, exclusion list for all_channels_except.'
Copy file name to clipboardExpand all lines: bin/commands/chat.rb
+3-2Lines changed: 3 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -146,7 +146,7 @@ class App
146
146
g.long_desc%( Starts a new streaming conversation. )
147
147
g.command'startStream'do |c|
148
148
c.flag'channel',desc: 'An encoded ID that represents a channel, thread, or DM.'
149
-
c.flag'chunks',desc: 'Array of streaming chunks.'
149
+
c.flag'chunks',desc: 'Array of streaming chunks. Can include markdown text chunk objects, task update chunk objects, plan update chunks, or blocks chunks.'
150
150
c.flag'markdown_text',desc: 'Accepts message text formatted in markdown. Limit this field to 12,000 characters.'
151
151
c.flag'thread_ts',desc: "Provide another message's ts value to reply to. Omit it to stream a top-level message instead of a thread reply; this is only supported in channels where the whole channel is one session, such as Slack Code, and returns invalid_thread_ts elsewhere. Passing '0' is equivalent to omitting it."
152
152
c.flag'recipient_user_id',desc: 'The encoded ID of the user to receive the streaming text. Required when streaming to channels.'
@@ -164,11 +164,12 @@ class App
164
164
g.long_desc%( Stops a streaming conversation. )
165
165
g.command'stopStream'do |c|
166
166
c.flag'channel',desc: 'An encoded ID that represents a channel, private group, or DM.'
167
-
c.flag'chunks',desc: 'Array of streaming chunks.'
167
+
c.flag'chunks',desc: 'Array of streaming chunks. Can include markdown text chunk objects, task update chunk objects, plan update chunks, or blocks chunks.'
168
168
c.flag'ts',desc: 'The timestamp of the streaming message.'
169
169
c.flag'markdown_text',desc: 'Accepts message text formatted in markdown. Limit this field to 12,000 characters.'
170
170
c.flag'blocks',desc: 'A list of blocks that will be rendered at the bottom of the finalized message.'
171
171
c.flag'metadata',desc: '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.'
172
+
c.flag'session_status',desc: 'The session status to set after stopping the stream.'
Copy file name to clipboardExpand all lines: bin/commands/oauth_v2.rb
+21Lines changed: 21 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -22,6 +22,27 @@ class App
22
22
end
23
23
end
24
24
25
+
g.desc'Call this to rotate the secret on an old API token with a short secret. Must be paired with a call to oauth.v2.completeShortTokenRotation to confirm the change.'
26
+
g.long_desc%( Call this to rotate the secret on an old API token with a short secret. Must be paired with a call to oauth.v2.completeShortTokenRotation to confirm the change. )
27
+
g.command'beginShortTokenRotation'do |c|
28
+
c.flag'client_id',desc: 'Issued when you created your application. Must be the app the token being rotated was issued to.'
29
+
c.flag'client_secret',desc: 'Issued when you created your application.'
g.desc'Call this to finish rotating the secret on an old API token with a short secret. Must be paired with a call to oauth.v2.beginShortTokenRotation to start the process.'
36
+
g.long_desc%( Call this to finish rotating the secret on an old API token with a short secret. Must be paired with a call to oauth.v2.beginShortTokenRotation to start the process. )
37
+
g.command'completeShortTokenRotation'do |c|
38
+
c.flag'client_id',desc: 'Issued when you created your application. Must be the app the token being rotated was issued to.'
39
+
c.flag'client_secret',desc: 'Issued when you created your application.'
40
+
c.flag'new_token',desc: 'The new xoxp token returned by oauth.v2.beginShortTokenRotation.'
Copy file name to clipboardExpand all lines: bin/commands/slackLists_items.rb
+1Lines changed: 1 addition & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -56,6 +56,7 @@ class App
56
56
c.flag'limit',desc: 'The maximum number of records to return.'
57
57
c.flag'cursor',desc: 'Next cursor for pagination.'
58
58
c.flag'archived',desc: 'Boolean indicating whether archived items or normal items should be returned.'
59
+
c.flag'include_list',desc: 'Set to true to also return the parent list object, including its title, column schema, and total row count. Defaults to false to keep the response small.'
Copy file name to clipboardExpand all lines: lib/slack/web/api/endpoints/admin_apps_permissions.rb
+8Lines changed: 8 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -15,6 +15,8 @@ module AdminAppsPermissions
15
15
# List of user IDs to allow for named_entities visibility.
16
16
# @option options [array] :usergroup_ids
17
17
# List of encoded usergroup IDs.
18
+
# @option options [array] :channel_ids
19
+
# List of encoded channel IDs to add to the channel restriction list. Interpretation depends on the app's channel_restriction_mode, which is configured via the admin.apps.permissions.set method.
# List of user IDs whose named_entities access will be revoked.
44
46
# @option options [array] :usergroup_ids
45
47
# List of encoded usergroup IDs.
48
+
# @option options [array] :channel_ids
49
+
# List of encoded channel IDs to remove from the channel restriction list. Interpretation depends on the app's channel_restriction_mode, which is configured via the admin.apps.permissions.set method.
# The mode that defines where the app can be used in channels.
70
+
# @option options [array] :channel_ids
71
+
# List of encoded channel IDs for channel restrictions. Semantics depend on channel_restriction_mode: allowlist for specific_channels, exclusion list for all_channels_except.
# A list of blocks that will be rendered at the bottom of the finalized message.
294
294
# @option options [string] :metadata
295
295
# 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.
296
+
# @option options [enum] :session_status
297
+
# The session status to set after stopping the stream.
# Call this to rotate the secret on an old API token with a short secret. Must be paired with a call to oauth.v2.completeShortTokenRotation to confirm the change.
36
+
#
37
+
# @option options [string] :client_id
38
+
# Issued when you created your application. Must be the app the token being rotated was issued to.
# Call this to finish rotating the secret on an old API token with a short secret. Must be paired with a call to oauth.v2.beginShortTokenRotation to start the process.
51
+
#
52
+
# @option options [string] :client_id
53
+
# Issued when you created your application. Must be the app the token being rotated was issued to.
54
+
# @option options [string] :client_secret
55
+
# Issued when you created your application.
56
+
# @option options [string] :new_token
57
+
# The new xoxp token returned by oauth.v2.beginShortTokenRotation.
# Boolean indicating whether archived items or normal items should be returned.
85
+
# @option options [boolean] :include_list
86
+
# Set to true to also return the parent list object, including its title, column schema, and total row count. Defaults to false to keep the response small.
0 commit comments