Annotations
Annotation Tags - List
List all annotation tags for the organization. Supports optional authentication for public agent access.
GET
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
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.string
Unique identifier of the annotation tag (CUID format).
string
Name of the annotation tag.
string
ID of the organization the tag belongs to.
string
ISO 8601 timestamp of when the tag was created.
string
ISO 8601 timestamp of when the tag was last updated.

