Update Tag

GA
POST

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: tasktask_revision
tag_idstringRequired

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

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
Allowed values: tasktask_revision

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

idstringformat: "uuid"

Unique identifier for the tag.

project_idstringformat: "uuid"

Project this tag belongs to.

created_atdatetime

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_idstringOptionalformat: "uuid"

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

childrenlist of objectsOptional

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

Errors

Built with