Default Workspace and Membership

When To Use It

Use this flow when a signed-in user needs to discover accessible workspaces or switch the default workspace.

Prerequisites

1. valid JWT session
2. valid X-Client-Hash
3. onboarding flow completed enough to resolve workspace context

Call Sequence

1. load the user's workspace list
2. determine the active or default workspace
3. change the default workspace if the UX supports switching

Branch Decisions

1. one workspace or many
2. existing default workspace or not
3. self-managed choice or admin-managed restrictions

Common Failures

1. wrong assumption that workspace data lives inside onboarding
2. portal and role mismatch
3. stale JWT session

Reference Entry