Skip to main content
POST
Enqueue an erasure job (subject or inbox)

Authorizations

Authorization
string
header
required

Dairo API key, e.g. dairo_test_... or dairo_live_...

Headers

Idempotency-Key
string

Optional idempotency key for safe retries of side-effecting operations.

Maximum string length: 128

Body

application/json
subjectHandle
string<email>
required

The data subject's email address to erase across all stored mail.

idempotencyKey
string

Optional caller-supplied key; a retry with the same key returns the same job.

Response

Accepted

Acknowledgement that an erasure job was enqueued.

jobId
string<uuid>
required
kind
enum<string>
required
Available options:
erase_subject,
purge_inbox
status
enum<string>
required
Available options:
pending,
running,
completed,
failed
createdAt
string<date-time>
required