> For the complete documentation index, see [llms.txt](https://docs.asters.ai/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.asters.ai/api/endpoints/labels.md).

# Labels

## List of all labels of a workspace

<mark style="color:green;">`GET`</mark> `https://api.asters.ai/api/external/v1.0/workspaces/{{workspace_id}}/labels`

#### Headers

| Key                                         | Value                                               |
| ------------------------------------------- | --------------------------------------------------- |
| x-api-key<mark style="color:red;">\*</mark> | API Key generated in Asters for user authentication |

{% tabs %}
{% tab title="200 Social accounts successfully recovered" %}

```javascript
{
    "description": "Labels in workspace",
    "data": [
        {
            "_id": "6811f76c3aa4bf3deb1e940b",
            "label": "label 1",
            "color": "purple"
        },
        {
            "_id": "6811f76f3aa4bf3deb1e948d",
            "label": "label 2",
            "color": "blue"
        },
        {
            "_id": "6811f7733aa4bf3deb1e94a4",
            "label": "label 3",
            "color": "red"
        },
        {
            "_id": "6811f7773aa4bf3deb1e94b7",
            "label": "label 4",
            "color": "green"
        },
        {
            "_id": "6811f77f3aa4bf3deb1e94ca",
            "label": "label 5",
            "color": "yellow"
        }
    ],
    "error": null
}
```

{% endtab %}

{% tab title="401 Permission denied" %}

{% endtab %}

{% tab title="500: Internal Server Error Internal server error" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}