Delete a connected account

Soft-deletes a connected account by marking it as deleted in the database. This prevents the account from being used for API calls but preserves the record for audit purposes. Pass ?revoke_on_delete=true to also revoke the account's upstream credentials via a background job.

delete/api/v3.1/connected_accounts/{nanoid}

Path parameters

nanoidstring connectedAccountId required

The unique identifier (nanoid) of the connected account

Query parameters

revoke_on_deleteboolean nullable

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. The account is marked as deleted but retained in the database for historical purposes.

successboolean required

Indicates whether the connected account was successfully deleted

revoke_job_idstring

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 response

{
  "success": true
}

Changes

Changed in 2 of the 61 revisions of this API.4

Jun 17, 2026589a7d115a5e3See the full diff
- ○
  the endpoint scheme security CookieAuth was removed from the API
  api-security-removed
- ○
  added the new optional query request parameter revoke_on_delete
  new-optional-request-parameter
- ○
  added the optional property to the response with the status
  response-optional-property-added
May 5, 202652c71f747c651See the full diff
- ○
  endpoint added
  endpoint-added

Full history