Create New Tag

GA
POST

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

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

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

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