Revoke a connection
revoke_oauth_grantDisconnect one assistant by revoking its OAuth grant, immediately invalidating all its tokens and the key behind them. Provide the connection ID from list_oauth_grants; repeat calls return not_found.
Instructions
Purpose: disconnect one assistant. Every token it holds, and the key behind them, die immediately. NOT for: an assistant acting on its own. A key is refused with human_action_required. Do this in the console Connections page. Returns: the connection id and deleted: true. Repeating the call on an already-revoked id is not_found.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"grant_id": "<grant_id>"
},
"name": "revoke_oauth_grant"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| grant_id | Yes | The connection id from list_oauth_grants. | |
| idempotency_key | No | Your own key for this action. Retrying with the same key returns the first result instead of doing it twice — send one whenever a retry could double the effect. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Identifier. | |
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| deleted | No |