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.