Skip to main content
POST
/
v2
/
api
/
conversations
/
items
/
{id}
/
tags
Add tags
curl --request POST \
  --url https://api.withallo.com/v2/api/conversations/items/{id}/tags \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tags": [
    "qualified",
    "follow_up"
  ]
}
'
{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}
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 already exists on the item returns a 409 error with code TAG_ALREADY_EXISTS. No action is taken — the tag remains applied.

​
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