Update Tag

PUT /tags/:id

Update an existing tag. All fields are optional — only provided fields will be updated.

Path Parameters

Parameter	Type	Description
id	string (uuid)	The tag ID to update

Request Body

Field	Type	Required	Description
name	string	No	Updated tag name
slug	string	No	Updated slug. Must remain unique within your account
description	string	No	Updated description

Example

curl -X PUT https://api.getnexor.ai/api/public/tags/123e4567-e89b-12d3-a456-426614174001 \
  -H "Content-Type: application/json" \
  -H "X-API-Key: nxr_live_your_api_key" \
  -d '{
    "name": "Updated Name",
    "slug": "updated-slug",
    "description": "New description"
  }'

Responses

200 — Tag updated successfully

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174001",
    "name": "Updated Name",
    "slug": "updated-slug",
    "description": "New description",
    "created_at": "2026-01-15T09:00:00Z",
    "updated_at": "2026-01-20T14:30:00Z"
  }
}

401 — Authentication error

See Authentication.

404 — Tag not found

Tag does not exist or does not belong to your account.

409 — Conflict

{
  "error": "A tag with this slug already exists"
}

500 — Internal server error