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

{
  "data": {
    "id": "string",
    "slug": "slack-acme",
    "scope": "space",
    "spaceId": "string",
    "ownerUserId": "string",
    "type": "remote_mcp",
    "name": "Slack (Acme)",
    "config": {},
    "credentialRef": "string",
    "definitionId": "string",
    "operationPolicy": "read_only",
    "authStatus": "connected",
    "authErrorCode": "string",
    "authErrorMessage": "string",
    "authCheckedAt": "string",
    "tokenExpiresAt": "string",
    "verificationStatus": "ready",
    "verificationMessage": "string",
    "verificationCheckedAt": "string",
    "installedActionId": "string",
    "enabled": true,
    "createdBy": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "deletedAt": "string",
    "contract": {
      "schemaVersion": 1.1,
      "connectionType": "string",
      "driver": "remote_mcp",
      "capabilities": [
        "mcp_tools"
      ],
      "verification": {
        "strategy": "mcp_discovery",
        "live": true
      },
      "permissions": {
        "read": true,
        "write": true
      },
      "provenance": "builtin"
    }
  }
}

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