Bulk-delete many mailbox messages in a single call

POST https://api.dairo.app/v1/messages/batch-delete

Permanently deletes up to 1000 mailbox messages named in messageIds in one call, removing each message and its stored bytes — the raw email plus every attachment. Deletion is owner-scoped and partial-success: the response is { deleted: [...], failed: [{ id, error }] }, and a malformed, unknown, or foreign id lands in failed rather than aborting the batch. An empty messageIds, or more than 1000 ids, returns 400. This is irreversible and emits no webhook event; it requires the messages:read scope — the same scope that reads the mailbox, since the messages surface has no separate delete scope.

Scope: messages:read. Send the API key as a bearer token; Scopes lists what each one reaches.

Request

curl -X POST "https://api.dairo.app/v1/messages/batch-delete" \
  -H "Authorization: Bearer $DAIRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messageIds": [
      "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    ]
  }'

Body

Required, application/json: BatchDeleteMessagesRequest.

Response

200 Success. Body: application/json, BatchDeleteResult.

{
  "object": "batch_delete_result",
  "deleted": [
    "string"
  ],
  "failed": [
    {
      "id": "string",
      "error": "string"
    }
  ]
}

Errors

Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.