AgentConnect
GitLab

Disconnect or remove a GitLab.com connection

On a live connection: revokes the OAuth grant when possible, removes the stored token pair, and keeps the row so its projects can still be listed — project bindings are never deleted implicitly (§9.4). On an already-disconnected connection that administers no projects: removes the row, under a lock that makes a racing project create meet the refusal rather than be detached. Removal is refused with 409 while any project is still assigned to it.

DELETE
/v1/orgs/{orgId}/gitlab/connections/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

orgId*string
id*string

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/orgs/string/gitlab/connections/string"
{  "removed": true,  "connection": {    "id": "string",    "gitlabUserId": "string",    "gitlabUsername": "string",    "state": "connected",    "scopes": [      "string"    ],    "connectedBy": "string",    "mine": true,    "accessExpiresAt": "string",    "assignedProjects": -9007199254740991,    "instanceUrl": "string",    "instanceVersion": "string",    "instanceVersionSupported": true,    "instanceVersionFloor": "string",    "createdAt": "string"  }}