Skip to main content
POST
Bulk-delete many mailbox messages in a single call

Authorizations

Authorization
string
header
required

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

Body

application/json
messageIds
string<uuid>[]
required

The message ids to delete (1-1000).

Required array length: 1 - 1000 elements

Response

Partial-success result.

object
enum<string>
required
Available options:
batch_delete_result
deleted
string[]
required

The ids that were successfully deleted.

failed
object[]
required

Per-id failures; never aborts the rest of the batch.