interview-join

Start Interview Call

Start an interview for a candidate joining via {token}.

Branches on interviewer_type:

  • "brain" → start a brain session via core.brain_session_runner and return StartBrainResponse. The candidate page then runs the text + voice loop against /brain/turn.
  • "human" / null / Vapi screening → return StartCallResponse with the Vapi assistant config.

This is a PUBLIC endpoint - no authentication required.

post/api/interview/join/{token}/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/interview/join/{token}/start
  • Auth: none declared

Path parameters

tokenstring required

Request body

recording_consentobject nullable

Response

Successful Response

unknown required

Changes

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