> ## 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"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.