Create New Tag

GA

Create a new tag for organizing and filtering Tasks or Task Revisions.

Tags provide a flexible way to organize your Tasks and Task Revisions. They can be used to:

  • Group related Tasks (e.g., ‘production’, ‘staging’, ‘experimental’)
  • Filter Tasks in the UI and API responses
  • Create hierarchical organizations with parent-child relationships
  • Mark Tasks for specific workflows or stages

Tags must have alphanumeric names (max 15 characters) and can optionally be organized in a hierarchy using parent_id.

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:

Headers

AuthorizationstringRequired

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

Request

This endpoint expects an object.
namestringRequired

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

entity_typeenumRequired

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

Allowed values:
parent_idstringOptionalformat: "uuid"

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

Response

Successfully created 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