> ## 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 connected app from the Agentcard account

Revokes a third-party app's access to the user's Agentcard account. It disconnects the app and invalidates its OAuth tokens, so the app must reconnect via OAuth to regain access; get the `clientId` from `list_connections`.

## Parameters

| Parameter   | Type   | Required | Description                                                         |
| ----------- | ------ | -------- | ------------------------------------------------------------------- |
| `client_id` | string | Yes      | The OAuth client ID of the app to revoke (from `list_connections`). |

## Returns

A confirmation with `status: "revoked"` and the number of OAuth tokens that were invalidated. If the app had no active access (already revoked, or a wrong `clientId`), it returns `status: "not_connected"` and suggests checking `list_connections`.

## Example

```json theme={null}
{ "name": "revoke_connection", "arguments": { "client_id": "client_abc123" } }
```