---
title: "Bulk delete inbox messages"
method: POST
path: "/v1/inbox/bulk-delete"
tags: ["Inbox"]
---

# Bulk delete inbox messages

`POST /v1/inbox/bulk-delete`

## Request

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

Delete up to 200 messages per call. Messages are grouped by mailbox
so each mailbox uses a single IMAP connection. DynamoDB cache rows
are removed only for UIDs that the IMAP delete confirmed.

## Request body

- object
  - `messages` object[], required
    - `uid` string, required: IMAP message UID.
    - `mailbox` string, email, required: Mailbox the message belongs to.

## Response `200`

Bulk delete result

- object
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time
  - `data` object
    - `deleted` integer
    - `failed` integer
    - `errors` object[]
      - `uid` string
      - `mailbox` string
      - `error` string

## Other responses

- `400`: Validation error
- `401`: Authentication required or token invalid

---

[API](https://skmtc.dev/winnr/apis/winnr-api.md) · [All operations](https://skmtc.dev/winnr/apis/winnr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/winnr/apis/winnr-api/revisions/a4f960beb1eb?raw)