Read the onboarding draft
The current setup draft: scan steps, profile, status. 404 SETUP_DRAFT_NOT_FOUND once it expired.
Authorizations
Clerk API key. Create one in Settings → API Keys. Pass as Authorization: Bearer <key>. Keys carry a scope — read, write (implies read) or admin (implies write) — chosen when the key is minted. Each operation's security requirement (and its x-required-scope extension) names the minimum scope it needs; request the least-privileged key that covers the operations you call.
Query Parameters
The draft_… id. Optional on every onboarding route: defaults to the onboarding's current draft.
1 - 64"draft_k3v9x0q2m1"
Response
200 response
draft_… id.
"draft_k3v9x0q2m1"
Where the draft is in the setup engine. The scan moves scanning → scanned (or failed).
scanning, scanned, proposing, measuring, sampling, ready, needs_narrowing, failed, applied What the domain scan learned about the company. Every field the wizard renders is editable.
True when the profile came from the domain cache.
True when an existing draft (same owner + domain, < 24 h) was returned.
ISO-8601.
