Skip to main content
PATCH
Update role

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
template_name
string

Display name

status
enum<string>

Lifecycle status

Available options:
draft,
active,
archived
skills
string[]

Technical skills (replaces list)

soft_skills
string[]

Soft skills (replaces list)

use_case
enum<string>
Available options:
hiring,
admissions,
training,
custom_api
description
string

Raw job-description text

knowledge_base_extracted
string

AI-formatted job description in Markdown (the JD shown in the UI)

requires_approval
boolean

Gate self-applications behind HR approval

default_duration_minutes
integer

Session length

default_difficulty
enum<string>

Question depth

Available options:
beginner,
intermediate,
advanced,
expert,
adaptive

Response

Success

Last modified on July 26, 2026