## 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"
  }
]
```
