Skip to main content
Request principal-scoped grant revocation and vault freezing through the configured kill-switch implementation. The confirm_scope literal ‘ALL_AGENTS_THIS_PRINCIPAL’ is required to prevent accidental invocation. Review the returned counts and outstanding actions. This operation cannot reverse settled transfers or guarantee cancellation of calls already in flight. The dashboard’s Pause all action is separately scoped to one entity and revokes grants and agents without guaranteeing on-chain vault freezes.

Metadata

Annotations

Input schema

Output schema

Auth

Caller’s grant must include the agent:budget:revoke scope. Grants whose scope set is a superset of the required scope are accepted.

Request examples

Response examples

Success
Wrong confirm_scope literal

Errors

Idempotency note: This tool is marked idempotent. Calling it a second time after a successful execution returns the same result shape without performing a second revocation sweep. Calling it with a different reason after a prior successful call is a no-op on the revocation side (all grants are already revoked); executed_at will reflect the second call’s timestamp but counts will be 0.