Delete a connection
connection:deletePermanently deletes the connection and its encrypted credential. No soft delete, no undo.
Workflows are NOT checked and NOT updated: any step still carrying this connectionId keeps a reference that now resolves to nothing and will fail at run time. Call GET /api/connections/usage first to see what references it, or POST /api/connections/{id}/replace to repoint those workflows before deleting.
This is the one connection operation that needs the stronger connection:delete permission rather than connection:write.
Authorization
bearerAuth An API token: Authorization: Bearer grt_…. Mint one in the app under Settings → Workspace → API tokens; the raw value is shown once. Scopes confine the token — see x-permission on each operation.
In: header
Path Parameters
The connection's UUID.
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/api/connections/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "data": { "message": "Connection deleted" }}