Connected Accounts
Authentication
Revoke a connected account at the provider
Best-effort upstream revocation. On success, the connection transitions to REVOKED. Returns 400 when the toolkit does not support programmatic revocation, 409 when the connection is not in a revokable state, 500 when every upstream dispatch fails.
post/api/v3.1/connected_accounts/{nanoid}/revoke
Path parameters
nanoidstring connectedAccountId required
The unique identifier of the connected account
Response
Connection revoked. revoked_tokens reports which subjects were killed at the provider on this call; an empty array indicates the connection was already revoked.
Example response
{
"revoked_tokens": [
"access_token",
"refresh_token"
],
"connected_account": {
"id": "ca_1a2b3c4d5e6f",
"status": "REVOKED"
}
}