---
title: "Revoke a mandate"
method: POST
path: "/v1/mandates/{id}/revoke"
---

# Revoke a mandate

`POST /v1/mandates/{id}/revoke`

## Request

- Base URL: `https://agentmandate-api.com`
- URL: `https://agentmandate-api.com/v1/mandates/{id}/revoke`
- Auth: HTTP bearer

Adds the mandate to your account's revocation list. Idempotent — revoking twice is not an error. Verifications read a briefly cached copy of that list so they never block on the database, so a revocation takes effect within about ten seconds rather than instantly. That window is stated here rather than hidden.

## Path parameters

- `id` string, required

## Request body

- object
  - `reason` string

## Response `200`

Success

- object
  - `mandateId` string
  - `revoked` boolean
  - `effectiveWithinSeconds` integer

## Other responses

- `400`: Deterministic error. Branch on `code`; quote `requestId` when reporting a problem.
- `401`: Deterministic error. Branch on `code`; quote `requestId` when reporting a problem.
- `429`: Deterministic error. Branch on `code`; quote `requestId` when reporting a problem.
- `500`: Deterministic error. Branch on `code`; quote `requestId` when reporting a problem.

---

[API](https://skmtc.dev/agentmandate-api/apis/agent-mandate.md) · [All operations](https://skmtc.dev/agentmandate-api/apis/agent-mandate/llms.txt) · [OpenAPI document](https://skmtc.dev/agentmandate-api/apis/agent-mandate/revisions/463fe122c4d8?raw)