> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# revoke_connection

> Revoke a third-party app's access to the user's Agentcard account.

Connect to `https://mcp.agentcard.sh/mcp` with the **user's connection token** (or a `buy_token` for org-owned accounts).

**Behavior:** destructive, idempotent.

## What it does

Revoke a third-party app's access to the user's Agentcard account. Disconnects the app and invalidates its OAuth tokens; it must reconnect via OAuth to regain access. Pass the clientId shown by list\_connections.

## Inputs

| Field                    | Type   | Description                                                        |
| ------------------------ | ------ | ------------------------------------------------------------------ |
| `client_id` *(required)* | string | The OAuth client ID of the app to revoke (from list\_connections). |

## Returns

| Field                  | Type   | Description                                                                                                |
| ---------------------- | ------ | ---------------------------------------------------------------------------------------------------------- |
| `message` *(required)* | string | Human-readable outcome.                                                                                    |
| `status`               | string | Result status: "revoked" when tokens were invalidated, "not\_connected" when the app had no active access. |
| `revoked`              | number | Number of OAuth tokens that were revoked.                                                                  |
| `clientId`             | string | The client ID that was revoked.                                                                            |

## Example call

```json theme={null}
{
  "tool": "revoke_connection",
  "arguments": {
    "client_id": "\u2026"
  }
}
```