Conversations

Tag a conversation

POSThttps://api.batzap.com/v1/chats/{chat_id}/tags

Adds an existing tag to a conversation. Creating tags is a separate permission: see Create a tag.

Scope: chats:write
Rate limit: Write · 60/min

Path parameters

chat_iduuidrequired

Conversation id, as returned by List conversations.

Body parameters

tag_iduuidrequired

Tag id.

Errors

400

Missing tag_id, or the chat or tag does not exist in your organization.

Plus the errors every route can return: see Errors.

PreviousAssign a conversation Next Untag a conversation

curl -X POST "https://api.batzap.com/v1/chats/0b6e9d1f-2a4c-4e8b-b6d0-7f3a5c9e1b24/tags" \
  -H "Authorization: bzp_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tag_id": "8c4e2a6f-1d3b-4f5a-9e7c-0b2d4f6a8c13"
  }'

Response 200

{
  "success": true,
  "message": "Tag added to chat successfully"
}