Profile and Onboarding

When To Use It

Use this flow after authentication when the UI needs account basics, onboarding state, and next-step routing.

Prerequisites

1. valid JWT session
2. valid X-Client-Hash
3. correct portal entrypoint

Call Sequence

1. fetch own profile
2. fetch onboarding state
3. branch into workspace selection, invitation handling, or normal app entry

Branch Decisions

1. onboarding complete or not
2. default workspace exists or not
3. invitation inbox needs separate loading

Common Failures

1. treating onboarding as a full invitation aggregate
2. missing JWT
3. fingerprint mismatch
4. portal mismatch

Reference Entry