---
title: "Revoke a connected account at the provider"
method: POST
path: "/api/v3.1/connected_accounts/{nanoid}/revoke"
tags: ["Connected Accounts", "Authentication"]
---

# Revoke a connected account at the provider

`POST /api/v3.1/connected_accounts/{nanoid}/revoke`

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.

## Path parameters

- `nanoid` string, connectedAccountId, required

## Response `200`

Connection revoked. `revoked_tokens` reports which subjects were killed at the provider on this call; an empty array indicates the connection was already revoked.

- object — Result of revoking a connected account at the upstream provider.
  - `revoked_tokens` string[], required — Tokens revoked at the provider on this call. Empty array means the connection was already revoked (no upstream dispatch).
  - `connected_account` object, required
    - `id` string, required — The unique identifier of the connected account
    - `status` 'INITIALIZING' | 'INITIATED' | 'ACTIVE' | 'FAILED' | 'EXPIRED' | 'INACTIVE' | 'REVOKED', required — The connection status after this call (REVOKED on success).

## Other responses

- `400` — Bad request - non-OAUTH2 auth scheme or toolkit lacks a revoke configuration.
- `401` — Unauthorized - Authentication failed
- `403` — Forbidden - Insufficient permissions to revoke this connected account
- `404` — Not found - Connected account does not exist, was deleted, or its parent auth config was removed.
- `409` — Conflict - Connection is in a state that cannot be revoked (only ACTIVE / already-REVOKED are accepted).
- `500` — Internal server error - DB failure, data integrity violation, or every upstream dispatch failed.

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/versions/4239836857f8/schema)