Skip to main content
POST
Create interview

Authorizations

Authorization
string
header
required

Organisation API key created in Assess → Developer → API Keys. Format: Bearer ct_live_<your-key> (live) or Bearer ct_test_<your-key> (test). Optional per-key CIDR allowlists return 403 IP_NOT_ALLOWED.

Body

Public wire uses task_* field names; maps to internal coding/org case ids.

title
string
required
Required string length: 1 - 300
interview_type
enum<string>
Available options:
coding,
technical,
system_design,
behavioral,
mixed
interviewer_mode
enum<string>
Available options:
ai_only,
human_only,
hybrid
candidate_email
Maximum string length: 254
candidate_name
string
Maximum string length: 200
time_limit_minutes
integer | null
Required range: 0 <= x <= 2147483647
scheduled_at
string<date-time> | null
active_language
enum<string>
Available options:
python,
javascript,
typescript,
sql,
java,
go,
bash
integrity_config
any
job_description
string
default:""
resume_text
string
default:""
voice_mode
boolean
default:false
human_can_join
boolean
default:false
target_role
string
default:""
Maximum string length: 200
target_company
string
default:""
Maximum string length: 200
difficulty
enum<string>
default:mid
Available options:
entry,
mid,
senior,
staff,
coding_task_ids
string<uuid>[]
org_task_ids
string<uuid>[]
persona
object
send_invite
boolean
default:true
pipeline_enrollment_id
string<uuid> | null
candidate_session_id
string<uuid> | null

Optional completed Screen session in this organisation. Candidate email must match.

Response

id
string<uuid>
required
read-only
title
string
required
Maximum string length: 300
candidate_token
string
required
Maximum string length: 64
org_id
string<uuid> | null
required
read-only
questions
object[]
required
read-only
messages
object[]
required
read-only
created_at
string<date-time>
required
read-only
identity_match
enum<string>
required
read-only
Available options:
linked,
mismatch,
unlinked
candidate_session_id
string<uuid> | null
required
read-only
linked_assessment_title
string
required
read-only
linked_assessment_slug
string
required
read-only
mode
enum<string>
Available options:
org,
engineer
interview_type
enum<string>
Available options:
coding,
technical,
system_design,
behavioral,
mixed
status
enum<string>
Available options:
prepared,
scheduled,
waiting,
active,
ended,
expired,
no_show
interviewer_mode
enum<string>
Available options:
ai_only,
human_only,
hybrid
human_can_join
boolean
active_language
enum<string>
Available options:
python,
javascript,
typescript,
sql,
java,
go,
bash
time_limit_minutes
integer | null
Required range: 0 <= x <= 2147483647
scheduled_at
string<date-time> | null
started_at
string<date-time> | null
ended_at
string<date-time> | null
candidate_name
string
Maximum string length: 200
candidate_email
Maximum string length: 254
integrity_config
any
whiteboard_snapshot
unknown
voice_mode
boolean
job_description
string
resume_text
string
target_role
string
Maximum string length: 200
target_company
string
Maximum string length: 200
difficulty
enum<string>
Available options:
entry,
mid,
senior,
staff,
session_metadata
any
Last modified on September 5, 2026