Skip to content

Commit a74e612

Browse files
author
Slack API Ref Buildbot
committed
Updated from Slack docs, 2026/01/28
1 parent 69fcbd1 commit a74e612

16 files changed

Lines changed: 186 additions & 16 deletions

‎docs.slack.dev/methods/admin.functions.permissions.lookup.json‎

Lines changed: 86 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,89 @@
4040
"metadata"
4141
],
4242
"properties": {
43+
"permissions": {
44+
"type": "object",
45+
"patternProperties": {
46+
"^Fn[A-Z0-9]{8,}$": {
47+
"type": "object",
48+
"required": [
49+
"distribution",
50+
"allowed_by_admin",
51+
"allowed_entities"
52+
],
53+
"properties": {
54+
"distribution": {
55+
"type": "object",
56+
"required": [
57+
"type"
58+
],
59+
"properties": {
60+
"type": {
61+
"type": "string",
62+
"enum": [
63+
"everyone",
64+
"app_collaborators",
65+
"named_entities"
66+
]
67+
},
68+
"user_ids": {
69+
"type": "array",
70+
"items": {
71+
"schema": "user_id"
72+
}
73+
}
74+
}
75+
},
76+
"allowed_by_admin": {
77+
"schema": "functions_permissions_admin_list_item"
78+
},
79+
"allowed_entities": {
80+
"schema": "functions_permissions_list_item"
81+
},
82+
"private_channel_access": {
83+
"type": "object",
84+
"required": [
85+
"permission"
86+
],
87+
"properties": {
88+
"permission": {
89+
"type": "string",
90+
"enum": [
91+
"everyone",
92+
"named_entities",
93+
"no_one"
94+
]
95+
},
96+
"user_ids": {
97+
"type": "array",
98+
"desc": "List of user IDs to allow for `named_entities` visibility.",
99+
"example": "['U00000001', 'U00000002', 'U00000003']",
100+
"items": {
101+
"schema": "user_id"
102+
}
103+
},
104+
"team_ids": {
105+
"type": "array",
106+
"desc": "List of team IDs to allow for `named_entities` visibility.",
107+
"example": "['T00000001', 'T00000002', 'T00000003']",
108+
"items": {
109+
"schema": "workspace_id"
110+
}
111+
},
112+
"org_ids": {
113+
"type": "array",
114+
"desc": "List of org IDs to allow for `named_entities` visibility.",
115+
"example": "['E00000001', 'E00000002', 'E00000003']",
116+
"items": {
117+
"schema": "enterprise_id"
118+
}
119+
}
120+
}
121+
}
122+
}
123+
}
124+
}
125+
},
43126
"metadata": {
44127
"type": "object",
45128
"patternProperties": {
@@ -48,7 +131,7 @@
48131
"properties": {
49132
"workflows_using": {
50133
"type": "integer",
51-
"desc": "the number of workflows with a step function of this type"
134+
"desc": "The number of workflows with a step function of this type."
52135
}
53136
}
54137
}
@@ -57,7 +140,7 @@
57140
"errors": {
58141
"type": "object",
59142
"patternProperties": {
60-
"../common/schemas/common_defs_schema.json#/function_id": {
143+
"function_id": {
61144
"type": "string"
62145
}
63146
}
@@ -69,7 +152,7 @@
69152
"desc": "This actor does not have access to the permissions on this resource."
70153
},
71154
"restricted_action": {
72-
"desc": "User does not have access to this API"
155+
"desc": "User does not have access to this API."
73156
}
74157
},
75158
"examples": {

‎docs.slack.dev/methods/admin.functions.permissions.set.json‎

Lines changed: 52 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,9 @@
1212
"type": "object",
1313
"required": [
1414
"token",
15-
"function_id",
16-
"visibility"
15+
"function_id"
1716
],
17+
"discardAdditionalProperties": true,
1818
"properties": {
1919
"token": {
2020
"type": "string",
@@ -28,7 +28,7 @@
2828
},
2929
"visibility": {
3030
"type": "string",
31-
"desc": "The function visibility",
31+
"desc": "The function visibility.",
3232
"enum": [
3333
"everyone",
3434
"app_collaborators",
@@ -38,12 +38,51 @@
3838
},
3939
"user_ids": {
4040
"type": "array",
41-
"desc": "List of user IDs to allow for named_entities visibility.",
41+
"desc": "List of user IDs to allow for `named_entities` visibility.",
4242
"example": "['U00000001', 'U00000002', 'U00000003']",
4343
"items": {
44-
"schema": "user_id"
44+
"$schema": "user_id"
4545
},
46-
"maxItems": 200
46+
"maxItems": 200,
47+
"uniqueItems": true
48+
},
49+
"permissions": {
50+
"type": "array",
51+
"desc": "Array of permissions for the function.",
52+
"items": {
53+
"type": "object",
54+
"required": [
55+
"visibility",
56+
"permission_type"
57+
],
58+
"properties": {
59+
"visibility": {
60+
"type": "string",
61+
"enum": [
62+
"everyone",
63+
"named_entities",
64+
"no_one"
65+
]
66+
},
67+
"permission_type": {
68+
"type": "string",
69+
"enum": [
70+
"slack_function",
71+
"private_channel_access"
72+
]
73+
},
74+
"user_ids": {
75+
"type": "array",
76+
"desc": "List of user IDs to allow for `named_entities` visibility.",
77+
"example": "['U00000001', 'U00000002', 'U00000003']",
78+
"items": {
79+
"$schema": "user_id"
80+
},
81+
"maxItems": 200,
82+
"uniqueItems": true
83+
}
84+
}
85+
}
4786
}
4887
}
4988
},
@@ -58,11 +97,17 @@
5897
"invalid_visibility": {
5998
"desc": "Invalid value for visibility."
6099
},
100+
"invalid_permission_type": {
101+
"desc": "Invalid value for permission type."
102+
},
103+
"invalid_permission": {
104+
"desc": "Invalid value for permission"
105+
},
61106
"unknown_method": {
62107
"desc": "This method does not exist."
63108
},
64109
"invalid_setting": {
65-
"desc": "The app_collaborators setting is not allowed for apps not owned by your team/org."
110+
"desc": "The `app_collaborators` setting is not allowed for apps not owned by your team/org."
66111
},
67112
"restricted_action": {
68113
"desc": "This actor does not have access to the permissions on this resource."

‎docs.slack.dev/methods/admin.users.setAdmin.json‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,9 @@
4343
"failed_to_set_user_to_admin": {
4444
"desc": "Designating this user as an admin failed."
4545
},
46+
"failed_to_set_admin_on_workspaces": {
47+
"desc": "Failed to set the user as an admin on all workspaces."
48+
},
4649
"feature_not_enabled": {
4750
"desc": "The Admin APIs feature is not enabled for this team."
4851
},

‎docs.slack.dev/methods/admin.users.setOwner.json‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,9 @@
4242
"failed_to_set_user_to_owner": {
4343
"desc": "The change to the user's role failed."
4444
},
45+
"failed_to_set_owner_on_workspaces": {
46+
"desc": "Failed to set the user as an owner on all workspaces."
47+
},
4548
"feature_not_enabled": {
4649
"desc": "The Admin APIs feature is not enabled for this team."
4750
},

‎docs.slack.dev/methods/admin.users.setRegular.json‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,9 @@
3636
},
3737
"output": null,
3838
"errors": {
39+
"cannot_set_org_admin_to_regular_at_workspace_level": {
40+
"desc": "Org admins cannot be set to regular at the workspace level. Change their user type at the org level instead."
41+
},
3942
"cannot_set_this_guest_to_regular_at_team_level": {
4043
"desc": "This guest cannot be set to regular because they are active on multiple workspaces."
4144
},

‎docs.slack.dev/methods/assistant.search.context.json‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -484,6 +484,9 @@
484484
"context_channel_not_found": {
485485
"desc": "Specified `context_channel_id` is invalid or the user lacks permission to view it."
486486
},
487+
"missing_scope": {
488+
"desc": "The requested channel types are not allowed by the provided scopes."
489+
},
487490
"assistant_search_context_disabled": {
488491
"desc": "We're having issues returning your search results. Please wait and try again."
489492
}

‎docs.slack.dev/methods/chat.startStream.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@
4040
"thread_ts": {
4141
"desc": "Provide another message's `ts` value to reply to. Streamed messages should always be replies to a user request.",
4242
"type": "string",
43-
"example": "1721609600"
43+
"example": "1721609600.123456"
4444
},
4545
"recipient_user_id": {
4646
"desc": "The encoded ID of the user to receive the streaming text. Required when streaming to channels.",

‎docs.slack.dev/methods/chat.update.json‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,19 @@
5454
}
5555
]
5656
},
57+
"unfurled_attachments": {
58+
"desc": "A JSON-based array of structured attachments, presented as a URL-encoded string.",
59+
"example": "[{\"pretext\": \"pre-hello\", \"text\": \"text-world\"}]",
60+
"anyOf": [
61+
{
62+
"type": "string",
63+
"subtype": "attachments"
64+
},
65+
{
66+
"type": "null"
67+
}
68+
]
69+
},
5770
"blocks": {
5871
"desc": "A JSON-based array of structured blocks, presented as a URL-encoded string.",
5972
"example": "[{\"type\": \"section\", \"text\": {\"type\": \"plain_text\", \"text\": \"Hello world\"}}]",

‎methods/admin/admin.functions.permissions.lookup.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@
3838
"org_login_required": "The workspace is undergoing an enterprise migration and will not be available until migration is complete.",
3939
"ratelimited": "The request has been ratelimited. Refer to the Retry-After header for when to retry the request.",
4040
"request_timeout": "The method was called via a POST request, but the POST data was either missing or truncated.",
41-
"restricted_action": "User does not have access to this API",
41+
"restricted_action": "User does not have access to this API.",
4242
"service_unavailable": "The service is temporarily unavailable.",
4343
"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.",
4444
"token_expired": "Authentication token has expired.",

‎methods/admin/admin.functions.permissions.set.json‎

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
"type": "string"
1111
},
1212
"visibility": {
13-
"required": true,
13+
"required": false,
1414
"desc": "The function visibility.",
1515
"type": "enum"
1616
},
@@ -19,6 +19,11 @@
1919
"example": "['U00000001', 'U00000002', 'U00000003']",
2020
"desc": "List of user IDs to allow for named_entities visibility.",
2121
"type": "array"
22+
},
23+
"permissions": {
24+
"required": false,
25+
"desc": "Array of permissions for the function.",
26+
"type": "array"
2227
}
2328
},
2429
"response": {
@@ -37,8 +42,10 @@
3742
"invalid_array_arg": "The method was passed an array as an argument. Please only input valid strings.",
3843
"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.",
3944
"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.",
45+
"invalid_permission": "Invalid value for permission",
46+
"invalid_permission_type": "Invalid value for permission type.",
4047
"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-
"invalid_setting": "The app_collaborators setting is not allowed for apps not owned by your team/org.",
48+
"invalid_setting": "The `app_collaborators` setting is not allowed for apps not owned by your team/org.",
4249
"invalid_visibility": "Invalid value for visibility.",
4350
"is_bot": "This method cannot be called by a legacy bot.",
4451
"method_deprecated": "The method has been deprecated.",

0 commit comments

Comments
 (0)