# List inbox labels

The workspace's own inbox labels — words people made and filed threads under — each with id, name and tone. These are the made half of the Inbox's labels; the other half is what a thread is connected to, read from the records each listed conversation is filed under. Filter the conversations list to one label with label=<id>.

Access class: `workspace`.

## Endpoint

`GET /v1/comms/labels`

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": [
    "string"
  ]
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
