Skip to content

Commit 69fcbd1

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

5 files changed

Lines changed: 144 additions & 0 deletions

File tree

docs.slack.dev/events/events.json

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1448,6 +1448,17 @@
14481448
"RTM"
14491449
]
14501450
},
1451+
{
1452+
"name": "user_connection",
1453+
"description": "A member's user connection status change requested",
1454+
"scopes": [
1455+
"users:write"
1456+
],
1457+
"APIs": [
1458+
"Events",
1459+
"RTM"
1460+
]
1461+
},
14511462
{
14521463
"name": "user_huddle_changed",
14531464
"description": "A user's huddle status has changed",
Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
{
2+
"desc": "Updates the connection status between a user and an app.",
3+
"http_method": "POST",
4+
"scope": {
5+
"user": [
6+
"users:write"
7+
]
8+
},
9+
"rate_limits": "t2",
10+
"args": {
11+
"type": "object",
12+
"required": [
13+
"token",
14+
"user_id",
15+
"status"
16+
],
17+
"discardAdditionalProperties": true,
18+
"properties": {
19+
"token": {
20+
"type": "string",
21+
"subtype": "auth",
22+
"desc": "Authentication token bearing required scopes. Tokens should be passed as an HTTP Authorization header or alternatively, as a POST parameter.",
23+
"example": "xxxx-xxxxxxxxx-xxxx"
24+
},
25+
"user_id": {
26+
"desc": "The ID of the user for the status update.",
27+
"type": "string",
28+
"example": "U12345678",
29+
"logged": true,
30+
"schema": "user_id"
31+
},
32+
"status": {
33+
"desc": "The status that should be set for the user.",
34+
"type": "string",
35+
"example": "connected",
36+
"enum": [
37+
"connected",
38+
"disconnected"
39+
]
40+
}
41+
}
42+
},
43+
"output": null,
44+
"errors": {
45+
"app_not_found": {
46+
"desc": "The app was not found."
47+
},
48+
"invalid_auth": {
49+
"desc": "The token doesn't have access to this endpoint."
50+
},
51+
"app_not_subscribed": {
52+
"desc": "The app is not subscribed to the required events."
53+
},
54+
"user_not_found": {
55+
"desc": "Value passed for `user_id` was invalid."
56+
}
57+
}
58+
}

docs.slack.dev/methods/methods.json

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -874,6 +874,13 @@
874874
"apps"
875875
]
876876
},
877+
{
878+
"name": "apps.user.connection.update",
879+
"description": "Updates the connection status between a user and an app.",
880+
"family": [
881+
"apps"
882+
]
883+
},
877884
{
878885
"name": "assistant.search.context",
879886
"description": "Searches messages across your Slack organization—perfect for broad, specific, and real-time data retrieval.",

events/user_connection.json

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"name": "user_connection",
3+
"desc": "A member's user connection status change requested.",
4+
"scopes": [
5+
"users:write"
6+
],
7+
"APIs": [
8+
"Events",
9+
"RTM"
10+
]
11+
}
Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
{
2+
"group": "apps",
3+
"name": "apps.user.connection.update",
4+
"deprecated": false,
5+
"desc": "Updates the connection status between a user and an app.",
6+
"args": {
7+
"user_id": {
8+
"required": true,
9+
"example": "U12345678",
10+
"desc": "The ID of the user for the status update.",
11+
"type": "string"
12+
},
13+
"status": {
14+
"required": true,
15+
"example": "connected",
16+
"desc": "The status that should be set for the user.",
17+
"type": "enum"
18+
}
19+
},
20+
"response": {
21+
"examples": []
22+
},
23+
"errors": {
24+
"access_denied": "Access to a resource specified in the request is denied.",
25+
"accesslimited": "Access to this method is limited on the current network.",
26+
"account_inactive": "Authentication token is for a deleted user or workspace when using a bot token.",
27+
"app_not_found": "The app was not found.",
28+
"app_not_subscribed": "The app is not subscribed to the required events.",
29+
"deprecated_endpoint": "The endpoint has been deprecated.",
30+
"ekm_access_denied": "Administrators have suspended the ability to post a message.",
31+
"enterprise_is_restricted": "The method cannot be called from an Enterprise.",
32+
"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.",
33+
"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.",
34+
"invalid_array_arg": "The method was passed an array as an argument. Please only input valid strings.",
35+
"invalid_auth": "The token doesn't have access to this endpoint.",
36+
"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.",
37+
"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.",
38+
"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.",
39+
"is_bot": "This method cannot be called by a legacy bot.",
40+
"method_deprecated": "The method has been deprecated.",
41+
"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.",
42+
"missing_scope": "The token used is not granted the specific scope permissions required to complete this request.",
43+
"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.",
44+
"not_allowed_token_type": "The token type used in this request is not allowed.",
45+
"not_authed": "No authentication token provided.",
46+
"org_login_required": "The workspace is undergoing an enterprise migration and will not be available until migration is complete.",
47+
"ratelimited": "The request has been ratelimited. Refer to the Retry-After header for when to retry the request.",
48+
"request_timeout": "The method was called via a POST request, but the POST data was either missing or truncated.",
49+
"service_unavailable": "The service is temporarily unavailable.",
50+
"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.",
51+
"token_expired": "Authentication token has expired.",
52+
"token_revoked": "Authentication token is for a deleted user or workspace or the app has been removed when using a user token.",
53+
"two_factor_setup_required": "Two factor setup is required.",
54+
"unknown_method": "This method is currently not available.",
55+
"user_not_found": "Value passed for `user_id` was invalid."
56+
}
57+
}

0 commit comments

Comments
 (0)