---
title: "Start Discovery Session"
method: POST
path: "/v1/onboarding/discovery"
tags: ["onboarding"]
---

# Start Discovery Session

`POST /v1/onboarding/discovery`

Start a fresh Discovery interview — the brief, empathetic call that runs
in front of the specialist setup.

On session end, the discovery template's webhook output fires
`/v1/webhooks/discovery-handoff`, which creates the next specialist
onboarding interview pre-filled with prefill_fragments + caller_context +
problem_shape and writes a `discovery_handoff` block onto this interview's
context. The frontend polls that block to advance.

## Request body

- DiscoverySessionRequest
  - `language` string, nullable

## Response `200`

Successful Response

- OnboardingSessionOut
  - `session_id` string, required
  - `interview_id` string, required
  - `join_token` string, required
  - `room_name` string, required
  - `livekit_url` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/roxels/apis/interviewer.md) · [All operations](https://skmtc.dev/roxels/apis/interviewer/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/roxels/interviewer/revisions/4ef48ed226e1/schema)