Disconnect a provider

Remove a connection for a provider. If connectionId is provided, deletes only that specific connection. Otherwise, deletes all connections for the provider on the profile. The resolved profile must belong to the authenticated actor (returns 403 otherwise).

DELETE/api/connections/{scope}/{name}

Authorization

better-auth.session_token<token>

Cookie session from Better Auth. Requires X-Org-Id header for org-scoped routes.

In: cookie

Path Parameters

scope*string

Provider scope (e.g. @appstrate)

Match^@[a-z0-9][a-z0-9-]*$

name*string

Provider name (e.g. gmail)

Query Parameters

profileId?string

Connection profile ID (defaults to user's default profile)

connectionId?string

Specific connection ID to delete. When provided, only this connection is removed (ignores profileId).

Formatuuid

Header Parameters

X-Org-Id?string

Organization ID. Required for cookie auth. Not needed for API key auth (org resolved from key).

Formatuuid

curl -X DELETE "https://loading/api/connections/string/string"

{
  "success": true
}

{
  "type": "https://docs.appstrate.dev/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Invalid or missing session",
  "code": "unauthorized",
  "requestId": "req_abc123"
}

{
  "type": "https://docs.appstrate.dev/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "Insufficient permissions",
  "code": "forbidden",
  "requestId": "req_abc123"
}