Revoke a mandate

POST /mandates/{id}/revoke · Mandates · version 2026-09-14

Effective on the next request. Does not require the agent's cooperation.

Never billed. Charging a customer to protect themselves makes no sense.

Revocation is final. To restore authority, issue a new mandate with a fresh proof of a live human.

Base URL

https://api.sidaxis.com/v1 in production, https://sandbox.api.sidaxis.com/v1 in sandbox.

Parameters

Name	In	Type	Required	Description
Authorization	header	string	required	Bearer sk_live_… in production, sk_test_… in sandbox.
Sidaxis-Version	header	string	optional	Dated version. Pin it in production.
id	path	string	required	The mandate to revoke.

Responses

200 — Revoked

status is revoked and every subsequent check answers allowed: false with reason mandate_revoked.

{
  "id": "mnd_9f41c7b2",
  "status": "revoked",
  "granted_to": "agent_7f2c",
  "scope": [
    "payment"
  ],
  "remaining": 0,
  "until": "2027-03-01T00:00:00Z",
  "receipt": {
    "id": "rcpt_be04d215",
    "anchor": "0x9a17f6cc2be5",
    "url": "https://verify.sidaxis.com/r/be04d215"
  }
}

Errors

not_found. See errors and refusals.

Notes

Revoking an already-revoked mandate returns the same 200. The call is safe to retry.

Subscribe to mandate.revoked if another system of yours needs to stop work too.