payments.mandates_revoke
Revoke a spend mandate
Scope: payments:spend
Mark a mandate as revoked. The on-chain session key is not uninstalled — do that manually from the Console if you want to fully retire the key. Settled payments are unaffected; future payments.pay() calls will fail with mandate_not_found until a new mandate is created.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
mandateId | string | Yes | Mandate id to revoke. |
Example
Agent: "Cancel my current spending policy — I don't trust this run anymore."
-> payments.mandates_revoke({ mandateId: "m_abc" })Returns
The revoked mandate row (same shape as payments.mandates_get) with revokedAt set.