Skip to content

Commit c88d61d

Browse files
author
Slack API Ref Buildbot
committed
Updated from Slack docs, 2026/01/16
1 parent f644b62 commit c88d61d

3 files changed

Lines changed: 178 additions & 0 deletions

File tree

Lines changed: 111 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,111 @@
1+
{
2+
"desc": "Exclude channels from Slack AI in bulk",
3+
"http_method": "GET",
4+
"scope": {
5+
"user": [
6+
"admin.conversations:write"
7+
]
8+
},
9+
"rate_limits": "t2",
10+
"args": {
11+
"type": "object",
12+
"required": [
13+
"token",
14+
"channel_ids",
15+
"exclude"
16+
],
17+
"properties": {
18+
"token": {
19+
"type": "string",
20+
"desc": "Authentication token bearing required scopes. Tokens should be passed as an HTTP Authorization header or alternatively, as a POST parameter.",
21+
"subtype": "auth",
22+
"example": "xxxx-xxxxxxxxx-xxxx"
23+
},
24+
"channel_ids": {
25+
"desc": "An array of channel IDs to exclude from Slack AI.",
26+
"type": "array",
27+
"minItems": 1,
28+
"maxItems": 100,
29+
"items": {
30+
"schema": "channel"
31+
},
32+
"example": "[\"C12345\", \"C98765\"]"
33+
},
34+
"exclude": {
35+
"desc": "Whether the channels should be excluded from Slack AI.",
36+
"type": "boolean",
37+
"example": "true"
38+
}
39+
}
40+
},
41+
"output": {
42+
"type": "object",
43+
"required": [
44+
"bulk_action_id",
45+
"not_added"
46+
],
47+
"properties": {
48+
"bulk_action_id": {
49+
"type": "string"
50+
},
51+
"not_added": {
52+
"desc": "The channel ID and reason it could not be excluded from Slack AI",
53+
"type": "array",
54+
"minItems": 1,
55+
"maxItems": 100,
56+
"items": {
57+
"type": "object",
58+
"required": [
59+
"channel_id",
60+
"errors"
61+
],
62+
"properties": {
63+
"channel_id": {
64+
"schema": "workspace_id"
65+
},
66+
"errors": {
67+
"desc": "The reason the channel was not added",
68+
"type": "array",
69+
"items": {
70+
"type": "string"
71+
}
72+
}
73+
}
74+
}
75+
}
76+
}
77+
},
78+
"errors": {
79+
"action_already_in_progress": {
80+
"desc": "Another bulk action request is currently in progress"
81+
},
82+
"internal_error": {
83+
"desc": "Something unexpected happened, try again in a little bit. Sorry for that!"
84+
},
85+
"no_valid_channels": {
86+
"desc": "All input channels are invalid"
87+
},
88+
"restricted_action": {
89+
"desc": "User does not have permission to perform this action"
90+
},
91+
"feature_not_enabled": {
92+
"desc": "The feature is not enabled"
93+
}
94+
},
95+
"examples": {
96+
"success": {
97+
"url": "/api/admin.conversations.bulkSetExcludeFromSlackAi?token=YOUR_TOKEN&channel_ids=C12345,C12346",
98+
"description": "Success response with a channel not added to the bulk action due to failing validation",
99+
"example": {
100+
"ok": true,
101+
"bulk_action_id": "Ab123456",
102+
"not_added": [
103+
{
104+
"channel_id": "C12346",
105+
"error": "invalid_channel"
106+
}
107+
]
108+
}
109+
}
110+
}
111+
}

docs.slack.dev/methods/methods.json

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -174,6 +174,13 @@
174174
"admin"
175175
]
176176
},
177+
{
178+
"name": "admin.conversations.bulkSetExcludeFromSlackAi",
179+
"description": "Exclude channels from Slack AI in bulk",
180+
"family": [
181+
"admin"
182+
]
183+
},
177184
{
178185
"name": "admin.conversations.convertToPrivate",
179186
"description": "Convert a public channel to a private channel.",
Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
{
2+
"group": "admin",
3+
"name": "admin.conversations.bulkSetExcludeFromSlackAi",
4+
"deprecated": false,
5+
"desc": "Exclude channels from Slack AI in bulk",
6+
"args": {
7+
"channel_ids": {
8+
"required": true,
9+
"example": "[\"C12345\", \"C98765\"]",
10+
"desc": "An array of channel IDs to exclude from Slack AI.",
11+
"type": "array"
12+
},
13+
"exclude": {
14+
"required": true,
15+
"example": "true",
16+
"desc": "Whether the channels should be excluded from Slack AI.",
17+
"type": "boolean"
18+
}
19+
},
20+
"response": {
21+
"examples": [
22+
"{\n \"ok\": true,\n \"bulk_action_id\": \"Ab123456\",\n \"not_added\": [\n {\n \"channel_id\": \"C12346\",\n \"error\": \"invalid_channel\"\n }\n ]\n}"
23+
]
24+
},
25+
"errors": {
26+
"access_denied": "Access to a resource specified in the request is denied.",
27+
"accesslimited": "Access to this method is limited on the current network.",
28+
"account_inactive": "Authentication token is for a deleted user or workspace when using a bot token.",
29+
"action_already_in_progress": "Another bulk action request is currently in progress",
30+
"deprecated_endpoint": "The endpoint has been deprecated.",
31+
"ekm_access_denied": "Administrators have suspended the ability to post a message.",
32+
"enterprise_is_restricted": "The method cannot be called from an Enterprise.",
33+
"fatal_error": "The server could not complete your operation(s) without encountering a catastrophic error. It's possible some aspect of the operation succeeded before the error was raised.",
34+
"feature_not_enabled": "The feature is not enabled",
35+
"internal_error": "Something unexpected happened, try again in a little bit. Sorry for that!",
36+
"invalid_arg_name": "The method was passed an argument whose name falls outside the bounds of accepted or expected values. This includes very long names and names with non-alphanumeric characters other than _. If you get this error, it is typically an indication that you have made a very malformed API call.",
37+
"invalid_array_arg": "The method was passed an array as an argument. Please only input valid strings.",
38+
"invalid_charset": "The method was called via a POST request, but the charset specified in the Content-Type header was invalid. Valid charset names are: utf-8 iso-8859-1.",
39+
"invalid_form_data": "The method was called via a POST request with Content-Type application/x-www-form-urlencoded or multipart/form-data, but the form data was either missing or syntactically invalid.",
40+
"invalid_post_type": "The method was called via a POST request, but the specified Content-Type was invalid. Valid types are: application/json application/x-www-form-urlencoded multipart/form-data text/plain.",
41+
"is_bot": "This method cannot be called by a legacy bot.",
42+
"method_deprecated": "The method has been deprecated.",
43+
"missing_post_type": "The method was called via a POST request and included a data payload, but the request did not include a Content-Type header.",
44+
"missing_scope": "The token used is not granted the specific scope permissions required to complete this request.",
45+
"no_permission": "The workspace token used in this request does not have the permissions necessary to complete the request. Make sure your app is a member of the conversation it's attempting to post a message to.",
46+
"no_valid_channels": "All input channels are invalid",
47+
"not_allowed_token_type": "The token type used in this request is not allowed.",
48+
"not_authed": "No authentication token provided.",
49+
"org_login_required": "The workspace is undergoing an enterprise migration and will not be available until migration is complete.",
50+
"ratelimited": "The request has been ratelimited. Refer to the Retry-After header for when to retry the request.",
51+
"request_timeout": "The method was called via a POST request, but the POST data was either missing or truncated.",
52+
"restricted_action": "User does not have permission to perform this action",
53+
"service_unavailable": "The service is temporarily unavailable.",
54+
"team_added_to_org": "The workspace associated with your request is currently undergoing migration to an Enterprise Organization. Web API and other platform operations will be intermittently unavailable until the transition is complete.",
55+
"token_expired": "Authentication token has expired.",
56+
"token_revoked": "Authentication token is for a deleted user or workspace or the app has been removed when using a user token.",
57+
"two_factor_setup_required": "Two factor setup is required.",
58+
"unknown_method": "This method is currently not available."
59+
}
60+
}

0 commit comments

Comments
 (0)