# Add tags

> Add one or more tags to a conversation item.

`POST /v2/api/conversations/items/{id}/tags`

<Note>
**Required scope:** `TAGS_WRITE`
</Note>

## Behavior

Pass tag **keys** (lowercase, slugified identifiers) — not display names. List available tags with `GET /v2/api/tags` to get the keys.

Adding a tag that's already on the item is a no-op: the request still returns `200` and the tag stays applied (no error, no duplicate).

## Idempotency

This endpoint supports the `Idempotency-Key` header. If a request succeeds and you retry with the same key, the stored response is returned without re-executing the operation. See [Idempotency](/docs/guides/error-handling#idempotency).
