Tag chat
Add tags to a chat, or remove them.
POST https://cotlet.dev/api/v1/livechat/chats/{chat_id}/tag
write
Adds the tags in add to a chat and removes the tags in remove. Tags must already exist in Settings > Tags, which only admins and the owner can change, and must be visible to your role. Works on active and archived chats. Tagging reaches no customer and is undone with one call, so tag_chat runs without asking first.
Parameters
| Name | Type | Description |
|---|---|---|
| chat_id string required | string | Chat ID from list_chats or list_archived_chats. |
| add string[] | string[] | Tag names to add. |
| remove string[] | string[] | Tag names to remove. |
Request
curl -X POST https://cotlet.dev/api/v1/livechat/chats/PJ0MRSHTDG/tag \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"add":["refund"]}'result = client.call("livechat", "tag_chat", {"chat_id":"PJ0MRSHTDG","add":["refund"]})const result = await cotlet.call('livechat', 'tag_chat', {"chat_id":"PJ0MRSHTDG","add":["refund"]});cotlet call livechat tag_chat --data '{"chat_id":"PJ0MRSHTDG","add":["refund"]}'Example response
{
"chat_id": "PJ0MRSHTDG",
"added": [
"refund"
],
"removed": [],
"tags": [
"refund"
]
}