---
title: "Label many messages"
method: POST
path: "/v1/inboxes/{inboxId}/messages/batch-update"
tags: ["Inboxes"]
---

# Label many messages

`POST /v1/inboxes/{inboxId}/messages/batch-update`

## Request

- Base URL: `https://api.volanea.com`
- URL: `https://api.volanea.com/v1/inboxes/{inboxId}/messages/batch-update`
- Auth: HTTP bearer

Add and/or remove your own labels on up to 100 messages. System labels can't be set or removed.

## Path parameters

- `inboxId` string, required

## Request body

- object
  - `emailIds` string[], required
  - `addLabels` string[]
  - `removeLabels` string[]

## Response `200`

Updated.

- object
  - `matched` integer

## Other responses

- `401`: Missing or invalid API key.
- `422`: Request validation failed (code `validation_error`, 422).

---

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