Allo

Add tags

Add one or more tags to a conversation item.

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

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.

Authorization

Authorizationstring · headerrequired

Api-Key ak_live_…

Path parameters

idstringrequired

Call ID (cll-*)

Body

tagsstring[]required

Tag keys to add

Responses

200Tags added successfully
401
404
429