> 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/workspaces.md).

# Workspaces

## List of all workspaces

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

#### Headers

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

{% tabs %}
{% tab title="200 Workspaces successfully recovered" %}

```javascript
{
    "description": "Workspaces of the user",
    "data": {
        "workspaces": [
            {
                "timezone": {
                    "name": "Europe/Rome",
                    "value": "UTC+02:00"
                },
                "_id": "6630bc19678a6f4e41d71c0d",
                "name": "Personale",
                "image": "6630bc19678a6f4e41d71bfe/undefined625cb3bf4183811a7d3f6df0_undefinedEmptyStateProfile-1677582541533-1714470255652.gif",
                "default": true,
                "user": "6630bc19678a6f4e41d71bfe",
                "created_at": "2024-04-30T09:38:33.380Z",
                "updated_at": "2024-04-30T09:38:33.380Z"
            },
            {
                "timezone": {
                    "name": "Europe/Rome",
                    "value": "UTC+02:00"
                },
                "_id": "663b3db7522ef4893db24536",
                "name": "Workspace 2",
                "image": "generic/workspace-placeholder.gif",
                "default": false,
                "user": "6630bc19678a6f4e41d71bfe",
                "created_at": "2024-05-08T08:54:15.094Z",
                "updated_at": "2024-05-08T08:54:15.094Z"
            },
            {
                "timezone": {
                    "name": "Europe/Rome",
                    "value": "UTC+02:00"
                },
                "_id": "66547c2c0c88066fdd89c9af",
                "name": "Workspace 3",
                "image": "generic/workspace-placeholder.gif",
                "default": false,
                "user": "6630bc19678a6f4e41d71bfe",
                "created_at": "2024-05-27T12:27:24.283Z",
                "updated_at": "2024-05-27T12:27:24.283Z"
            }
        ],
        "collabWorkspace": [],
        "allWorkspaces": [
            {
                "timezone": {
                    "name": "Europe/Rome",
                    "value": "UTC+02:00"
                },
                "_id": "6630bc19678a6f4e41d71c0d",
                "name": "Personale",
                "image": "6630bc19678a6f4e41d71bfe/undefined625cb3bf4183811a7d3f6df0_undefinedEmptyStateProfile-1677582541533-1714470255652.gif",
                "default": true,
                "user": "6630bc19678a6f4e41d71bfe",
                "created_at": "2024-04-30T09:38:33.380Z",
                "updated_at": "2024-04-30T09:38:33.380Z"
            },
            {
                "timezone": {
                    "name": "Europe/Rome",
                    "value": "UTC+02:00"
                },
                "_id": "663b3db7522ef4893db24536",
                "name": "Workspace 2",
                "image": "generic/workspace-placeholder.gif",
                "default": false,
                "user": "6630bc19678a6f4e41d71bfe",
                "created_at": "2024-05-08T08:54:15.094Z",
                "updated_at": "2024-05-08T08:54:15.094Z"
            },
            {
                "timezone": {
                    "name": "Europe/Rome",
                    "value": "UTC+02:00"
                },
                "_id": "66547c2c0c88066fdd89c9af",
                "name": "Workspace 3",
                "image": "generic/workspace-placeholder.gif",
                "default": false,
                "user": "6630bc19678a6f4e41d71bfe",
                "created_at": "2024-05-27T12:27:24.283Z",
                "updated_at": "2024-05-27T12:27:24.283Z"
            }
        ]
    },
    "error": null
}
```

{% endtab %}

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

{% endtab %}

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

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

{% endtab %}
{% endtabs %}