Workspaces

List Mine

List the caller's workspaces.

Phase 2 wiring (EPIC #114): on first call this lazily creates the user's "Personal" workspace via ensure_personal_workspace. We chose lazy-on-list rather than a global request middleware because:

  1. It only runs for endpoints that already resolve a user_id, so OAuth flows and health probes are untouched.
  2. The frontend always hits /api/workspaces to render the switcher on dashboard load, so the latency cost is amortised.
  3. ensure_personal_workspace is idempotent and race-safe (it checks for an existing Personal workspace by name+owner before inserting), so multiple concurrent requests converge to one row.
get/api/workspaces

Request

  • Base URL: https://api.kolens.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.kolens.ai/api/workspaces
  • Auth: HTTP bearer

Headers

x-kolens-user-idstring nullable
x-kolens-user-emailstring nullable

Response

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.