Delete connection

deleteConnection(projectReference: ID!, name: String!, connectionId: ID!, scope: ConnectionScope!): ConnectionDeletion!

Arguments

ArgumentTypeRequiredDescription
projectReferenceID!YesProject ID or slug. A missing or inaccessible project, including a denied scope-dependent project access check, returns not_found.
nameString!YesIntegration name, for example github.
connectionIdID!YesConnection ID from connectionStatus.
scopeConnectionScope!YesConnection owner. Project scope needs the editor role for project.integrations.connect; user scope needs viewer access to the project. API keys also need the integrations write scope. Verified user-session or API-key credentials are required; MCP OAuth grants and runtime credentials are refused.

Response

Returns ConnectionDeletion!. Open the type for its fields and nested types.

FieldTypeDescription
okBoolean!Always true: the connection was deleted.
providerRevokedBoolean!True when the provider confirmed revocation. False: credentials were deleted, revocation unconfirmed.

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

graphql
mutation DeleteConnection($projectReference: ID!, $name: String!, $connectionId: ID!, $scope: ConnectionScope!) {
  deleteConnection(projectReference: $projectReference, name: $name, connectionId: $connectionId, scope: $scope) {
    ok
    providerRevoked
  }
}
json
{
  "projectReference": "00000000-0000-4000-8000-000000000001",
  "name": "example",
  "connectionId": "00000000-0000-4000-8000-000000000001",
  "scope": "user"
}