Update a connection

PATCH

https://api.cloudraker.com/spaces/:spaceId/connections/:connectionId

PATCH

/spaces/:spaceId/connections/:connectionId

$ curl -X PATCH https://api.cloudraker.com/spaces/spaceId/connections/connectionId \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

200Updated

1 {
2   "data": {
3     "id": "string",
4     "slug": "slack-acme",
5     "scope": "space",
6     "spaceId": "string",
7     "ownerUserId": "string",
8     "type": "remote_mcp",
9     "name": "Slack (Acme)",
10     "config": {},
11     "credentialRef": "string",
12     "definitionId": "string",
13     "operationPolicy": "read_only",
14     "authStatus": "connected",
15     "authErrorCode": "string",
16     "authErrorMessage": "string",
17     "authCheckedAt": "string",
18     "tokenExpiresAt": "string",
19     "verificationStatus": "ready",
20     "verificationMessage": "string",
21     "verificationCheckedAt": "string",
22     "installedActionId": "string",
23     "enabled": true,
24     "createdBy": "string",
25     "createdAt": "string",
26     "updatedAt": "string",
27     "deletedAt": "string",
28     "contract": {
29       "schemaVersion": 1.1,
30       "connectionType": "string",
31       "driver": "remote_mcp",
32       "capabilities": [
33         "mcp_tools"
34       ],
35       "verification": {
36         "strategy": "mcp_discovery",
37         "live": true
38       },
39       "permissions": {
40         "read": true,
41         "write": true
42       },
43       "provenance": "builtin"
44     }
45   }
46 }

Updates name, slug, config, operationPolicy or enabled. Flipping operationPolicy to all provisions the approval-gated conn-<slug> action; flipping it back removes it. Renaming the slug re-provisions the action under the new slug. Authorization: space:contribute on the connection’s own space (404 when it lives elsewhere). Returns { data: Connection }.

Updates `name`, `slug`, `config`, `operationPolicy` or `enabled`. Flipping `operationPolicy` to `all` provisions the approval-gated `conn-<slug>` action; flipping it back removes it. Renaming the slug re-provisions the action under the new slug. Authorization: `space:contribute` on the connection’s own space (404 when it lives elsewhere). Returns `{ data: Connection }`.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired

connectionIdstringRequired

Request

This endpoint expects an object.

namestringOptional1-200 characters

slugstringOptionalformat: "^[a-z0-9]+(-[a-z0-9]+)*$"1-64 characters

configmap from strings to anyOptional

operationPolicyenumOptional

Allowed values:

enabledbooleanOptional

Response

The updated connection.

dataobject