---
title: Workspaces | FLORA API
description: List the FLORA workspaces available to your API key.
---

Workspaces are the top-level containers for projects, assets, techniques, runs, and credits. Most API calls that create or list resources require a `workspace_id`.

## List workspaces

Terminal window

```
curl https://app.flora.ai/api/v1/workspaces \
  -H "Authorization: Bearer sk_live_XXXX"
```

Response:

```
{
  "workspaces": [
    {
      "workspace_id": "ws_...",
      "name": "My Workspace"
    }
  ]
}
```

Use a returned `workspace_id` in later requests, such as listing projects or creating assets.

## Common endpoints

| Method | Path                 | Description                               |
| ------ | -------------------- | ----------------------------------------- |
| GET    | `/api/v1/workspaces` | List workspaces available to your API key |

## Notes

- If your API key belongs to one workspace, this endpoint still returns an array.
- Store the `workspace_id` in your server-side configuration alongside your API key.
- Do not expose API keys or workspace IDs in frontend-only code.