Skip to content
AlumiaDocs

Search docs

Find pages, headings, and concepts. Press ⌘K or Ctrl+K to toggle.

Workspaces

Workspace CRUD, members, settings, and switch — browser mutations need step-up.

Open in ChatGPTOpen in Claude

Workspaces partition projects, agents, and billing within an org.

Endpoints

MethodPathDescription
GET/api/v1/workspacesList workspaces.
POST/api/v1/workspacesCreate — browser session + step-up.
GET/api/v1/workspaces/:idFetch one workspace.
PATCH/api/v1/workspaces/:idUpdate — browser + step-up.
DELETE/api/v1/workspaces/:idDelete — 409 if non-empty; 400 if default workspace.
GET/api/v1/workspaces/:id/membersList members.
POST/api/v1/workspaces/:id/membersAdd member — browser + step-up.
DELETE/api/v1/workspaces/:id/membersRemove member.
POST/api/v1/workspaces/switchSet active workspace for the session.

API keys may read workspaces but cannot create, delete, or change membership.