---
title: "Start Onboarding Session"
method: POST
path: "/v1/onboarding/session"
tags: ["onboarding"]
---

# Start Onboarding Session

`POST /v1/onboarding/session`

Start a fresh onboarding agent session for this org.

Resolves the appropriate specialist template from the provided `kind`.
Defaults to `generic` if kind is omitted or unrecognized.

## Request body

- OnboardingSessionRequest
  - `kind` string, nullable
  - `picker_questionnaire` PickerQuestionnaireEntry[], nullable
    - `question` string, required
    - `answer` string, required
  - `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)