Skip to main content
GET
/
api
/
annotations
/
tags
curl --location --request GET 'https://dashboard.laburen.com/api/annotations/tags' \
--header 'Authorization: Bearer <API_KEY>'

[
  {
    "id": "clxxxxxxxxxxxxxxxxx",
    "name": "bug",
    "organizationId": "clxxxxxxxxxxxxxxxxx",
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-01-15T10:30:00.000Z"
  },
  {
    "id": "clxxxxxxxxxxxxxxxxx",
    "name": "feature-request",
    "organizationId": "clxxxxxxxxxxxxxxxxx",
    "createdAt": "2025-01-20T14:00:00.000Z",
    "updatedAt": "2025-01-20T14:00:00.000Z"
  }
]
This endpoint retrieves all annotation tags belonging to an organization. It supports:
  • Listing tags for the authenticated user’s organization
  • Public access when providing a public agent’s ID (no authentication required)
  • Tags are returned sorted alphabetically by name
Authentication is optional. If no session is provided, you must include an agentId query parameter referencing a public agent to resolve the organization.

​
Query Parameters

​
agentId
string
The ID of a public agent (CUID format). Used to resolve the organization when no authentication session is present. The agent must have visibility set to public.

​
Response

The response is an array of annotation tag objects.
​
id
string
Unique identifier of the annotation tag (CUID format).
​
name
string
Name of the annotation tag.
​
organizationId
string
ID of the organization the tag belongs to.
​
createdAt
string
ISO 8601 timestamp of when the tag was created.
​
updatedAt
string
ISO 8601 timestamp of when the tag was last updated.

​
Error Responses

Status CodeTypeDescription
401UNAUTHORIZEDNo valid session and no public agent agentId provided, or the agent is not public.
curl --location --request GET 'https://dashboard.laburen.com/api/annotations/tags' \
--header 'Authorization: Bearer <API_KEY>'

[
  {
    "id": "clxxxxxxxxxxxxxxxxx",
    "name": "bug",
    "organizationId": "clxxxxxxxxxxxxxxxxx",
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-01-15T10:30:00.000Z"
  },
  {
    "id": "clxxxxxxxxxxxxxxxxx",
    "name": "feature-request",
    "organizationId": "clxxxxxxxxxxxxxxxxx",
    "createdAt": "2025-01-20T14:00:00.000Z",
    "updatedAt": "2025-01-20T14:00:00.000Z"
  }
]