List your workspaces
Every workspace the person can open, the ones they own first, as the workspace switcher of the app lists them.
Runs the real call on your workspace.
GET /workspaces
Every workspace the person can open, the ones they own first, as the workspace switcher of the app lists them.
Example
Needs account:read. activeWorkspaceId is the workspace the app opens for the person, primaryWorkspaceId the first one they made, which can never be deleted, and personalWorkspaceId their personal space, which holds their free address and is not listed in data.
curl "$OE/workspaces" -H "$AUTH"{ "object": "list", "data": [ { "object": "workspace", "id": "10417196-e324-4283-af98-66ec62167c47", "name": "Acme", "slug": "acme", "email": "[email protected]", "isOwner": true, "ownerId": "q7Vd3kX9mT2pLw8RzN4bYc6HfJ1sGa5E", "plan": "business", "markUrl": null, "wordmarkUrl": null, "createdAt": "2026-08-01T10:00:00.000Z" } ], "activeWorkspaceId": "10417196-e324-4283-af98-66ec62167c47", "primaryWorkspaceId": "10417196-e324-4283-af98-66ec62167c47", "personalWorkspaceId": "5b1e7c40-2d9a-4f63-b8e1-0c4d7a2f9e15"}These calls act on a person, not on a workspace. An API key acts for the owner of the workspace it belongs to, and an app for the person who connected it. Reading needs account:read and every change account:write, and no role limits either.
The key or the app itself still acts for exactly one workspace in every other call. Nothing here widens it.