Skip to main content
DELETE
Disconnect an account and retire the grants that used it

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Headers

x-tenant-id
string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1
x-organization-id
string

Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.

Minimum string length: 1

Path Parameters

connectionId
string<uuid>
required

Integration connection id (UUID) as returned by managedAgentsListIntegrationConnections.

Response

Summary of what removing an integration connection retired. Returned when a connection is disconnected, so a caller can see how many vault grants it invalidated.

Summary of what removing an integration connection retired. Returned when a connection is disconnected, so a caller can see how many vault grants it invalidated.

connection_id
string
required

Connection that was disconnected (UUID). Adding the same GitHub installation later creates a new connection; saved agent references remain on this retired ID.

deleted
boolean
required

Always true on success: the connection row was soft-deleted and this service will no longer mint tokens for it. The app itself is deliberately left installed at the provider.

grants_revoked
integer
required

Number of vault grants that referenced this connection and have stopped working. They are not restored by reconnecting and must be recreated.

Required range: -9007199254740991 <= x <= 9007199254740991