delete_inbox · Escouade Mail documentation

Delete an inbox.

Deletes an inbox: its drafts and queued messages are cancelled, and the mail account is deleted if Escouade Mail created it (an inbox attached by an Escouade Mail administrator is only detached). Threads remain readable in the log. Irreversible: pass confirm = true.

Access

Key: an Escouade Mail key with manage_inboxes.
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
`inbox_id`	string	yes	The inbox to delete (inb_…).
`confirm`	boolean	yes	Must be true: deletion is irreversible.

Call it

Terminal

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

The full page in French, with the response fields and every refusal the tool can return: /mail/docs/reference/delete_inbox.