---
title: "Update many mentions"
description: "Change up to 100 mentions at once: status, assignee, labels to add or remove.\n\n- All of it lands, or none of it.\n- Unknown ids come back in `notFound`.\n- Removals run before additions. See [Labels and automations](/guides/labels)."
canonical: https://docs.mentio.dev/api/mentions/update-mentions
markdown: https://docs.mentio.dev/api/mentions/update-mentions.mdx
---

# Update many mentions

`POST /v1/mentions/batch`

Change up to 100 mentions at once: status, assignee, labels to add or remove.

- All of it lands, or none of it.
- Unknown ids come back in `notFound`.
- Removals run before additions. See [Labels and automations](/guides/labels).

## Parameters

- `idempotency-key` (header): A unique value (a UUID) for this request. Retrying with the same key within 24 hours returns the first response instead of creating twice.

## Body

- `ids` (required): Mention ids (mm_...), 1 to 100: a page of GET /v1/mentions.
- `update` (required): Every field is optional, at least one is required; omitted fields are untouched.

## Responses

- 200: Which mentions changed, and which ids were not found
- 400: Invalid request (an empty update, more than 100 ids), or invalid_assignee: the assignee is not a workspace member
- 401: Missing or invalid API key

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx