Skip to main content
PATCH
Update a question

Authorizations

Authorization
string
header
required

API key authentication for the public API. Pass your API key as a Bearer token.

Path Parameters

job_id
string<uuid>
required
question_id
string<uuid>
required

Body

application/json
answer_format
enum<string>

Closed: yes/no, factual, date, number, single-choice; the voice agent should accept the answer and move on without probing for elaboration. Open: behavioral or descriptive; the voice agent should probe for examples and depth.

  • closed - Closed
  • open - Open
Available options:
closed,
open
question
string

The actual question text.

Minimum string length: 1
interview_instructions
string | null

Per-question authoring override for the voice agent. Combines what to ask, how to phrase it, and any depth/probing override that diverges from the answer_format default (e.g. 'this is closed but spend 30s on the why').

Response

id
string<uuid>
required
read-only
created_at
string<date-time>
required
read-only
updated_at
string<date-time>
required
read-only
answer_format
enum<string>
required

Closed: yes/no, factual, date, number, single-choice; the voice agent should accept the answer and move on without probing for elaboration. Open: behavioral or descriptive; the voice agent should probe for examples and depth.

  • closed - Closed
  • open - Open
Available options:
closed,
open
question
string
required

The actual question text.

sequence_number
integer | null
required
read-only
is_active
boolean
required
read-only

Inactive questions are not asked in new interviews.

interview_instructions
string | null

Per-question authoring override for the voice agent. Combines what to ask, how to phrase it, and any depth/probing override that diverges from the answer_format default (e.g. 'this is closed but spend 30s on the why').