Get Tag
GET
/org/:org_id/project/:project_id/:entity_type/tag/:tag_id
Get tag details for the requested entity type.
Authentication
AuthorizationBearer
Bearer token authentication using JWT tokens from Ory Kratos/Hydra
Path parameters
org_idstringRequired
format: "uuid"The unique identifier of the organization.
project_idstringRequired
format: "uuid"The unique identifier of the project.
entity_typeenumRequired
The type of entity this tag applies to (task, task_revision, task_share, skill, or task_agent_revision).
Allowed values:
tag_idstringRequired
format: "uuid"The unique identifier (UUID) of the tag to operate on.
Response
Tag details
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, task_revision, task_share, skill, or task_agent_revision)
idstring
format: "uuid"Unique identifier for the tag.
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.
is_global_tagboolean
When true, indicates this is a global tag that is not scoped to a project.
parent_idstring or null
format: "uuid"Optional UUID of a parent tag. Used to create hierarchical tag structures (e.g., staging under production).
project_idstring or null
format: "uuid"Project this tag belongs to. Null means the tag is global.
childrenlist of objects
List of child tags if this tag is used as a parent in a hierarchical structure.
tagged_entitieslist of strings
List of entity IDs this tag is associated with.
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error