Discard email content
Permanently deletes the email's raw bytes, parsed body (text + HTML), and attachments while preserving metadata (sender, recipient, subject, timestamps, hashes, attachment manifest) for audit logs. Idempotent: a second call returns success with already_discarded: true and does no work.
Gated on the customer's discard-content opt-in (managed in the dashboard at Settings > Webhooks). When the toggle is off, this endpoint returns 403 with code discard_not_enabled and a message pointing the human at the dashboard. There is intentionally no API to flip this toggle. Opting in to a destructive, non-reversible operation must be a deliberate human click in the UI.
Headers
Optional client-supplied idempotency key. Retrying a request with the same key returns the original result instead of performing the action a second time; if omitted the server derives one from the canonical payload hash. Safe to retry network failures without duplicating side effects.
Response
Discard result