Inbox

Bulk delete inbox messages as a background job

Same request body as /v1/inbox/bulk-delete, but the delete runs as a background job and the call returns immediately with a job id.

Prefer this for large selections. The delete uses one IMAP connection per mailbox, so a selection spanning many mailboxes can run for minutes — longer than the 30s API Gateway request limit, which would return a gateway timeout even though the delete completes. The job runs with a 15 minute budget instead.

Poll GET /v1/jobs/{job_id}. While running, progress.delete reads like "12/40 mailboxes". On completion result carries the same shape the synchronous endpoint returns: deleted, failed, errors.

post/v1/inbox/bulk-delete/async

Request

  • Base URL: https://api.winnr.app
  • URL: https://api.winnr.app/v1/inbox/bulk-delete/async
  • Auth: HTTP bearer

Request body

Response

Job accepted and started

Example response

{
  "data": {
    "job_id": "job_4f2c9a1b8e7d6c05",
    "status": "pending"
  }
}

Changes