onboarding

Start Setup From Picker

Skip-discovery entry point. The questionnaire path on /onboarding (and, later, the dashboard "Create new template" CTA) calls this to start a setup interview directly without going through a discovery call first.

Builds the same interview.context.prefill shape that the discovery-handoff webhook writes, so the specialist agent's PREFILL AWARENESS / recap behavior works identically regardless of entry path.

If surface == "embedded", attaches the "Embed Setup Handoff" skill at session-creation time. Other surfaces don't get the skill — they'll never hear MCP / API-key / coding-agent talk during setup.

post/v1/onboarding/setup-from-picker

Request body

kindstring required
surfacestring nullable
languagestring nullable
free_textstring nullable
picker_leafstring nullable

Response

Successful Response

session_idstring required
interview_idstring required
join_tokenstring required
room_namestring required
livekit_urlstring required

Changes

No recorded changes to this endpoint across all 1 revision of this API.