---
title: "List all labels"
method: GET
path: "/v1/workspaces/{workspace_id}/labels"
tags: ["Labels"]
---

# List all labels

`GET /v1/workspaces/{workspace_id}/labels`

## Request

- Base URL: `https://api.oxvo.com`
- URL: `https://api.oxvo.com/v1/workspaces/{workspace_id}/labels`
- Auth: API key in header `api_access_token`

List all labels available in the current account

## Response `200`

Success

- object
  - `payload` Label[]: Array of labels
    - `id` number: The ID of the label
    - `title` string: The title of the label
    - `description` string: The description of the label
    - `color` string: Hex color code for the label
    - `show_on_sidebar` boolean: Whether the label should appear in the sidebar

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/oxvo/apis/oxvo-apis.md) · [All operations](https://skmtc.dev/oxvo/apis/oxvo-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/oxvo/apis/oxvo-apis/revisions/9a8448cbd1fe?raw)