Skip to main content
DELETE
Delete connection

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

project_reference
string
required

Project ID or slug. A missing or inaccessible project, including a denied scope-dependent project access check, returns not_found.

Minimum string length: 1
name
string
required

Integration name, for example github or slack.

Minimum string length: 1
connection_id
string<uuid>
required

Connection ID from getConnectionStatus or listProjectConnections.

Query Parameters

scope
enum<string>
required

Connection 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.

Available options:
user,
project

Response

Stored credentials deleted; provider_revoked reports whether provider revocation was confirmed.

id
string<uuid>
required

ID of the deleted connection.

status
enum<string>
required

Always deleted: the stored credentials were removed.

Available options:
deleted
provider_revoked
boolean
required

True when the provider confirmed revocation. False: credentials were deleted, revocation unconfirmed.