Skip to main content
DELETE
Delete a connected account

Authorizations

x-api-key
string
header
default:your-project-api-key
required

Your Composio project API key. Create or copy it from the Composio dashboard.

Path Parameters

nanoid
string<connectedAccountId>
required

The unique identifier (nanoid) of the connected account

Query Parameters

revoke_on_delete
boolean | null
default:false

When true, the delete also starts a background job that revokes the upstream credentials of every connected account in scope, and the response carries a revoke_job_id. Defaults to false. Revocation is irreversible — recovering a deleted entity does not restore working credentials.

Response

Successfully deleted the connected account.

Response returned after successfully deleting a connected account

success
boolean
required

Indicates whether the connected account was successfully deleted

revoke_job_id
string

Identifier of the background revoke job started for this delete. Present only when revoke_on_delete=true. Track the job and its per-connection results from the Composio dashboard — a programmatic endpoint to poll this job is not yet generally available.

Example:

"pj_1a2b3c4d5e6f"