Update a tag

PUThttps://api.batzap.com/v1/tags/{tag_id}

Renames a tag or changes its color. Conversations keep the tag.

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

Path parameters

tag_iduuidrequired

Tag id.

Body parameters

namestringoptional

New name.

colorstringoptional

Hex color. An empty string removes it.

Errors

400

Tag not found, empty name, invalid color or duplicate name.

Plus the errors every route can return: see Errors.

PreviousCreate a tag Next Delete a tag

curl -X PUT "https://api.batzap.com/v1/tags/8c4e2a6f-1d3b-4f5a-9e7c-0b2d4f6a8c13" \
  -H "Authorization: bzp_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "VIP customer"
  }'

Response 200

{
  "success": true,
  "message": "Tag updated successfully",
  "data": {
    "tag": {
      "id": "8c4e2a6f-1d3b-4f5a-9e7c-0b2d4f6a8c13",
      "name": "VIP customer",
      "color": "#16a34a",
      "created_at": "2026-08-01T10:00:00Z",
      "updated_at": "2026-08-01T10:00:00Z"
    }
  }
}