Rename a contact tag

PATCH

contacts

tags

{tagId}

curl -X PATCH "https://api.nedzo.ai/v1/contacts/tags/9b2f6c1e-1d2a-4f3b-8c4d-5e6f7a8b9c0d" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "customer" }'

{ "id": "9b2f6c1e-1d2a-4f3b-8c4d-5e6f7a8b9c0d", "workspaceId": "789e4567-e89b-12d3-a456-426614174000", "name": "customer", "createdAt": "2026-10-11T12:00:00Z", "updatedAt": "2026-10-12T09:00:00Z" }

Every plan can use this endpoint.

Path Parameters

string

required

Tag UUID

Body

string

required

The new name, 1 to 100 characters after trimming. It is stored lowercase, so "Customer" becomes "customer".

curl -X PATCH "https://api.nedzo.ai/v1/contacts/tags/9b2f6c1e-1d2a-4f3b-8c4d-5e6f7a8b9c0d" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "customer" }'

{ "id": "9b2f6c1e-1d2a-4f3b-8c4d-5e6f7a8b9c0d", "workspaceId": "789e4567-e89b-12d3-a456-426614174000", "name": "customer", "createdAt": "2026-10-11T12:00:00Z", "updatedAt": "2026-10-12T09:00:00Z" }

Errors

Status	When
`400`	`tagId` is not a UUID, or `name` is missing, empty or longer than 100 characters.
`404`	No tag has this id, or it is not in this key’s scope.
`409`	The workspace already has a tag with this name, in any case. The message is `A tag with this name already exists`.

curl -X PATCH "https://api.nedzo.ai/v1/contacts/tags/9b2f6c1e-1d2a-4f3b-8c4d-5e6f7a8b9c0d" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "customer" }'

{ "id": "9b2f6c1e-1d2a-4f3b-8c4d-5e6f7a8b9c0d", "workspaceId": "789e4567-e89b-12d3-a456-426614174000", "name": "customer", "createdAt": "2026-10-11T12:00:00Z", "updatedAt": "2026-10-12T09:00:00Z" }

API Reference

Workspaces

Agents

Phone Numbers

Contacts

Knowledge

Templates

Campaigns

Workflows

Conversations

Rename a contact tag

Path Parameters

Body

Errors