Update Connection Access

Replaces the full set of registered users excluded from a SHARED or ORGANIZATION connection. Each entry is a registered-user ID. Returns 400 for INDIVIDUAL connections or unknown registered-user IDs.

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Path parameters

connection_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

excluded_registered_userslist of stringsOptional

Full replacement list of registered user IDs to block from this SHARED or ORGANIZATION connection. Send [] to clear all exclusions.

Response

idstringRead-onlyformat: "uuid"

connectorobject

organization_idstringRead-onlyformat: "uuid"

auth_option_namestring or nullRead-only

auth_typestringRead-only

auth_scopestringRead-only

The connection’s scope: INDIVIDUAL, SHARED, or ORGANIZATION.

ownerobject

excluded_registered_userslist of stringsRead-only

Registered-user IDs blocked from this SHARED or ORGANIZATION connection. Always empty for INDIVIDUAL connections.

created_atdatetimeRead-only

modified_atdatetimeRead-only

$	curl -X PATCH https://ah-api.merge.dev/api/v1/connections/connection_id/ \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"id": "string",
3	"connector": {
4	"slug": "string",
5	"name": "string"
6	},
7	"organization_id": "string",
8	"auth_option_name": "string",
9	"auth_type": "string",
10	"auth_scope": "string",
11	"owner": {
12	"type": "string",
13	"id": "string",
14	"group": {
15	"key": "string",
16	"value": "string"
17	}
18	},
19	"excluded_registered_users": [
20	"string"
21	],
22	"created_at": "2024-01-15T09:30:00Z",
23	"modified_at": "2024-01-15T09:30:00Z"
24	}