API ReferenceTags

Create Tag

Create a new tag for organizing resources. Tags can be applied to: - Tasks and task revisions - Collections - Documents - Other resources Tags support hierarchical organization using prefixes.

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:

Request

This endpoint expects an object.
namestringRequired

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

Successful Response
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