API ReferenceTags

Update Tag

Update tag properties

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

Path Parameters

org_idstringRequiredformat: "uuid"
The unique identifier of the organization.
project_idstringRequiredformat: "uuid"
The unique identifier of the project.
entity_typeenumRequired

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

Allowed values:
tag_idstringRequiredformat: "uuid"

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

Request

This endpoint expects an object.
namestring or nullOptional

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

parent_idstring or nullOptionalformat: "uuid"

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

Response

Tag updated successfully
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.
tagged_entitieslist of strings or null
List of entity IDs this tag is associated with.

Errors