Interviews

Confirm Speaker Roles Endpoint

Answer the "who was the candidate?" question for an interview whose transcript participants couldn't be confidently matched to the scheduled candidate. Re-tags the transcript with the confirmed roles and queues the analysis that was paused — or, for a no-show, voids the interview so no score is fabricated.

Requires admin or recruiter role.

post/api/interviews/{interview_id}/confirm-roles

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}/confirm-roles
  • Auth: HTTP bearer

Path parameters

interview_idstring uuid required

Request body

candidate_speakerstring nullable
candidate_not_presentboolean

Response

Successful Response

successboolean required
interview_idstring required
speaker_roles_needs_confirmationboolean required
candidate_speakerstring nullable
candidate_not_presentboolean
rolesobject nullable
analysis_queuedboolean
messagestring nullable

Changes

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