Passer au contenu principal
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
  }
}

Documentation Index

Fetch the complete documentation index at: https://help.withallo.com/llms.txt

Use this file to discover all available pages before exploring further.

Scope requis : TAGS_WRITE

Comportement

Transmettez les cles des tags (identifiants en minuscules, slugifies) — pas les noms d’affichage. Listez les tags disponibles avec GET /v2/api/tags pour obtenir les cles. Ajouter un tag deja present sur l’element retourne une erreur 409 avec le code TAG_ALREADY_EXISTS. Aucune action n’est effectuee — le tag reste applique.

Idempotence

Cet endpoint prend en charge l’en-tete Idempotency-Key. Si une requete reussit et que vous la renvoyez avec la meme cle, la reponse stockee est retournee sans re-executer l’operation. Voir Idempotence.

Autorisations

Authorization
string
header
requis

Paramètres de chemin

id
string
requis

Call ID (cll-*)

Exemple:

"cll-abc123"

Corps

application/json
tags
string[]
requis

Tag keys to add

Réponse

Tags added successfully