revoke_key · Escouade Mail documentation

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

Terminal

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.