Skip to main content
PATCH
Update round

Authorizations

x-api-key
string
header
required

API key with the iv_live_ prefix. Create one under Developer → API Keys.

Path Parameters

id
string<uuid>
required

id identifier

Body

application/json
stage_name
string

Display name

stage_type
string

Interview format

duration_minutes
integer

Session length

interviewer
object

The AI interviewer for this round, created inline and linked atomically. Provide this OR interviewer_id.

interviewer_id
string<uuid>

Re-link to a different existing interviewer

stage_order
integer

Position in pipeline

difficulty
string

Question depth

pass_threshold
number

Min score to pass

automation_rule
string

Post-completion automation

status
enum<string>

Stage status

Available options:
draft,
active,
archived

Response

Success

Last modified on July 26, 2026