> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laburen.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Annotation Tags - List

> List all annotation tags for the organization. Supports optional authentication for public agent access.

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

<Note>
  Authentication is **optional**. If no session is provided, you must include an `agentId` query parameter referencing a public agent to resolve the organization.
</Note>

### Query Parameters

<ParamField query="agentId" type="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`.
</ParamField>

### Response

The response is an array of annotation tag objects.

<ResponseField name="id" type="string">
  Unique identifier of the annotation tag (CUID format).
</ResponseField>

<ResponseField name="name" type="string">
  Name of the annotation tag.
</ResponseField>

<ResponseField name="organizationId" type="string">
  ID of the organization the tag belongs to.
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp of when the tag was created.
</ResponseField>

<ResponseField name="updatedAt" type="string">
  ISO 8601 timestamp of when the tag was last updated.
</ResponseField>

### Error Responses

| Status Code | Type | Description |
| - | - | - |
| 401 | UNAUTHORIZED | No valid session and no public agent `agentId` provided, or the agent is not public. |

<RequestExample>
  ```bash cURL (authenticated) theme={null}
  curl --location --request GET 'https://dashboard.laburen.com/api/annotations/tags' \
  --header 'Authorization: Bearer <API_KEY>'
  ```

  ```bash cURL (public agent) theme={null}
  curl --location --request GET 'https://dashboard.laburen.com/api/annotations/tags?agentId=clxxxxxxxxxxxxxxxxx'
  ```

  ```javascript JavaScript theme={null}
  const apiUrl = 'https://dashboard.laburen.com/api';
  const apiKey = '<API_KEY>';

  const response = await fetch(`${apiUrl}/annotations/tags`, {
    method: 'GET',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
    },
  });

  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  api_url = "https://dashboard.laburen.com/api"
  api_key = "<API_KEY>"

  response = requests.get(
      f"{api_url}/annotations/tags",
      headers={
          "Authorization": f"Bearer {api_key}",
      },
  )

  data = response.json()
  print(data)
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  [
    {
      "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"
    }
  ]
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.