A workspace is the isolation boundary that holds collections. Over the public v2 API workspaces are read-only — they are created and administered elsewhere, and there is no workspaces.create or workspaces.delete.

List workspaces

curl "https://api.zeroset.com/v2/workspaces" \
  -H "Authorization: Bearer $NEBULA_ACCESS_TOKEN"

Returns a WorkspacePage: data, has_more and next_cursor. Page with ?limit= and ?cursor=; see Pagination.

Use an exchanged access token. Discovery requires resources:read and returns workspaces that both the key's limits and its owner's current permissions allow. Fetch one at GET /v2/workspaces/{workspace_id}.

Each Workspace carries workspace_id, organization_id, account_id, name, state, created_at and updated_at.

Suspended workspaces

state is active or suspended. Requests against a suspended workspace fail with workspace_suspended, which shares the forbidden type — branch on code, not type.