# Labels

## List labels

**get** `/v1/labels`

List the labels the user has created for organizing chats. Filter chats by label via GET /v1/chats/search with labelID.

### Returns

- `id: string`

  Unique identifier of the label.

- `name: string`

  Display name of the label.

### Example

```http
curl http://localhost:23373/v1/labels \
    -H "Authorization: Bearer $BEEPER_ACCESS_TOKEN"
```

#### Response

```json
[
  {
    "id": "id",
    "name": "name"
  }
]
```

## Domain Types

### Label

- `Label object { id, name }`

  A user-created label that organizes chats across accounts.

  - `id: string`

    Unique identifier of the label.

  - `name: string`

    Display name of the label.

### Label List Response

- `LabelListResponse = array of Label`

  Labels the user has created, sorted by name.

  - `id: string`

    Unique identifier of the label.

  - `name: string`

    Display name of the label.