Tags

Update Tag

GA

Update an existing tag’s properties.

Currently supports:

  • Renaming the tag (must remain alphanumeric, max 15 characters)
  • Cannot modify parent-child relationships after creation

Path parameters

org_idstringRequired
The unique identifier of the organization.
project_idstringRequired
The unique identifier of the project.
entity_typeenumRequired
The type of entity to tag
Allowed values:
tag_idstringRequired

The unique identifier (UUID) of the tag to operate on

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringOptional

New alphanumeric name for the tag (max 15 characters).

Response

Successfully updated tag
namestring

Alphanumeric name for the tag (max 15 characters). Used to organize and filter Tasks and Task Revisions.

entity_typeenum

The type of entity this tag applies to (task or task_revision)

Allowed values:
idstringformat: "uuid"
Unique identifier for the tag.
project_idstringformat: "uuid"
Project this tag belongs to.
created_atstring
ISO 8601 timestamp when the tag was created.
is_project_tagboolean

When true, indicates this is a project-level tag that can be used across multiple entity types.

parent_idstring or nullformat: "uuid"

Optional UUID of a parent tag. Used to create hierarchical tag structures (e.g., staging under production).

childrenlist of objects or null
List of child tags if this tag is used as a parent in a hierarchical structure.

Errors