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.

Path Parameters

connection_id
string<uuid>
required

Integration connection id (UUID) as returned by listIntegrationConnections.

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.