Skip to main content
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

ParameterTypeRequiredDescription
client_idstringYesThe 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

{ "name": "revoke_connection", "arguments": { "client_id": "client_abc123" } }