Email

Bulk delete messages

Compatibility endpoint that retry-safely moves messages to Trash. Returns the canonical durable per-item operation receipt plus the legacy count. Supply and reuse the Idempotency-Key header or compatibility idempotency_key field after timeouts.

post/api/emails/{address}/messages/delete

Request

  • Base URL: https://domani.run
  • URL: https://domani.run/api/emails/{address}/messages/delete
  • Auth: HTTP bearer

Path parameters

addressstring required

Mailbox email address (URL-encoded)

Headers

Idempotency-Keystring

Stable key for this exact logical batch

Request body

message_idsstring[] required

IDs of messages to delete

idempotency_keystring

Response

Messages moved to Trash with durable receipt

operation_idstring required
idempotency_keystring required
idempotent_replayboolean required

True when this response reused the immutable completed receipt and performed no new mutation.

action'move' | 'mark_read' | 'star' | 'restore' | 'delete_permanently' | 'label' required
status'succeeded' | 'partial' required
created_atstring date-time required
completed_atstring date-time nullable required
countinteger required

Changes

No recorded changes to this operation across all 2 revisions of this API.