Workspaces

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

List workspaces

curl https://app.flora.ai/api/v1/workspaces \
  -H "Authorization: Bearer ak_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

• API keys carry per-workspace read/write/billing permissions chosen in Settings → API Keys; this endpoint returns every workspace where the key has read access.
• 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.