Email & PEC

Permanently delete a captured message

Soft-deletes one archived message — its own permission, email:delete, separate from email:write, because this is a stronger act than trashing (see email_set_flags for the recoverable version). The database trigger still has the final word: a message under legal hold or mandatory retention refuses with LEGAL_HOLD or RETENTION_ACTIVE rather than being deleted. Confirm with the user first — there is no undo.

Examples

  • Delete that spam message DELETE /api/v1/rest/email/messages/11111111-2222-4333-8444-555555555555
delete/api/v1/rest/email/messages/{id}

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/email/messages/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Headers

X-Tenant-Idstring uuid

The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.

Response

Done. data is the tool’s own answer.

oktrue required
dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.