PATCH/tags/{uuid}

Update a tag name

Updates the name of a tag for the authenticated user's team. Supply name with 2 to 255 characters to replace the existing tag name. The response includes the updated tag and its timestamps.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 1 body field
uuidstringrequired
The UUID of the tag to update.

The tag name to set.

namestringrequired
The new tag name. Must be between 2 and 255 characters.

6 status codes
200Returns the updated tag, including its UUID, name, and creation and update timestamps.
created_atstringoptional
namestringoptional
updated_atstringoptional
uuidstringoptional
400Returned when the API token is invalid.
messagestringoptional
401Returned when the request is unauthenticated.
messagestringoptional
404Returned when the tag resource is not found.
messagestringoptional
409Returned when a tag with the requested name already exists.
422Returned when the request fails validation.
errorsobjectoptional
messagestringoptional

Error handling

A 400 is returned for an invalid token; a 401 when the request is unauthenticated; a 404 when the resource is not found; a 409 when a tag with the same name already exists; and a 422 for a validation error. The uuid path parameter must identify an existing tag. name is required and must be between 2 and 255 characters.