Interviews

Brain Start

Initialize a brain session for this interview. Returns the first question.

This is the admin/QA harness path — used by the internal Brain Sessions tool, not by candidates. Customer-facing brain interviews start via Vapi (interview_join.py → Vapi call.started → voice_webhooks.handle_call_started → deduct_action). Per ADR-0002, this admin path is excluded from billing.

post/api/interviews/{interview_id}/brain/start

Request

  • Base URL: https://api.thebetterhire.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.thebetterhire.ai/api/interviews/{interview_id}/brain/start
  • Auth: HTTP bearer

Path parameters

interview_idstring uuid required

Request body

resume_textstring nullable
jd_textstring nullable

Response

Successful Response

session_idstring required
first_questionstring required
stage_idstring required
modestring required
plan_summaryobject

Changes

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