Skip to main content
PUT
Only provided fields change. Renaming breaks nothing: assignments, filters and saved views all reference the tag’s id.
A tag stays in the field it was created in. To move one, create the tag in the other field and retag the records.

Authorizations

Authorization
string
header
required

The API key you created on the API settings page of the Clustr app.

Path Parameters

tag_id
string
required

Body

application/json

Only the fields you send change.

name
string | null

The tag's new name.

Maximum string length: 50
color
string | null

The tag's new color, like #3B82F6.

Maximum string length: 20
closes
boolean | null

Whether a record carrying this tag counts as closed.

Response

Typed result envelope.

success
boolean
required
data
object
required