Skip to main content
POST
Add tags
Required scope: TAGS_WRITE

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.

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

Call ID (cll-*)

Example:

"cll-abc123"

Body

application/json
tags
string[]
required

Tag keys to add

Response

Tags added successfully