> For an agent: the map of this documentation is at https://escouade.io/en/mail/docs/llms.txt; every page exists in Markdown, at the same address with `.md` appended.

# `revoke_key`

Revoke an access.

Removes an access to the space: an agent's key, or a connected assistant. It stops answering immediately, with no going back; what it had written or queued stays. An access cannot revoke itself. Pass confirm = true.

## Access

- **Key**: an Escouade Mail key with `approve`.
- **Space**: any space, verified or not.
- **Changes nothing**: no, it acts.
- **Safe to replay**: use an `idempotency_key` where the tool offers one.

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `key_id` | string | yes | The access to remove (key_…, see list_keys). |
| `confirm` | boolean | yes | Must be true: revocation cannot be undone. |

## Call it

```sh
curl -s https://api.subagent.fr/v1/revoke_key \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{"key_id": "…", "confirm": "…"}'
```

The full page in French, with the response fields and every refusal the tool can return: [/mail/docs/reference/revoke_key](https://escouade.io/mail/docs/reference/revoke_key).