Disconnect an account and retire the grants that used it
Disconnects the account and retires every credential grant that referenced it, returning how many grants were revoked. Agents holding those grants lose access to the provider on their next session; existing sessions are not torn down.
Authorizations
A Recursion API key, created in the console under API keys.
Headers
Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.
1Organization 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.
1Path Parameters
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 that was disconnected (UUID). Adding the same GitHub installation later creates a new connection; saved agent references remain on this retired ID.
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.
Number of vault grants that referenced this connection and have stopped working. They are not restored by reconnecting and must be recreated.
-9007199254740991 <= x <= 9007199254740991