Add labels

Add labels to a conversation and keep the ones it has.

POST https://cotlet.dev/api/v1/chatwoot/conversations/{conversation_id}/labels

write

Adds the labels you pass to the existing ones and returns the full list. A name that is not in list_labels fails and nothing is changed. Labels are account-specific and are not created by this tool. add_labels runs without asking first: it reaches no customer and is undone with one call.

Parameters

Parameters: add_labels
NameTypeDescription
conversation_id integer required integer conversation_id from list_conversations. It is the number in the conversation URL.
labels string[] required string[] Label names from list_labels.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/chatwoot/conversations/1842/labels \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"labels":["billing","refund"]}'
Python
result = client.call("chatwoot", "add_labels", {"conversation_id":1842,"labels":["billing","refund"]})
Node.js
const result = await cotlet.call('chatwoot', 'add_labels', {"conversation_id":1842,"labels":["billing","refund"]});
CLI
cotlet call chatwoot add_labels --data '{"conversation_id":1842,"labels":["billing","refund"]}'

Example response

JSON

{
  "conversation_id": 1842,
  "labels": [
    "billing",
    "refund"
  ],
  "added": [
    "billing",
    "refund"
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.