POST /interviews to create a new interview session for a candidate. Kovi returns a unique interviewUrl that the candidate uses to start the interview in their browser.
Endpoint
Request Body Parameters
The unique identifier for the job description associated with this interview (e.g.,
"JD-AI-7284"). Used to link the interview session to the correct role in your pipeline.The full name of the candidate (e.g.,
"Jane Smith"). Displayed in the scorecard and dashboard.The candidate’s email address (e.g.,
"jane@example.com"). Used to identify the candidate and associate their scorecard.The candidate’s mobile number in international format (e.g.,
"+1-5550001234"). Used for session recovery notifications.The job role or title being interviewed for (e.g.,
"AI Engineer", "Backend Developer"). Kovi uses this to tailor the interview content.The type of interview to conduct. Must be one of:
"Initial Screening"— High-level role and experience fit"Technical Deep Dive"— In-depth technical questions on the specified stack"System Design"— Architecture and design problem-solving"Behavioral"— Soft skills and situational questions"Full Stack"— Combined technical and behavioral evaluation
The seniority level to evaluate the candidate at. Controls question complexity and depth. Must be one of:
"Junior"— Foundation-level questions and fundamentals"Mid-Level to Senior"— Execution-focused questions with some architectural depth"Senior to Architect"— Architecture, system design, and leadership-level questions
An array of technologies the interview will focus on. Kovi restricts the dialogue strictly to your specified stack (e.g.,
["Python", "FastAPI", "GCP", "LangChain", "PostgreSQL"]).Maximum interview duration in minutes. Must not exceed 60 minutes. We recommend 15–30 minutes for screening sessions and 45–60 minutes for deep dives.
The minimum score a candidate must achieve to pass the interview. We recommend setting this between 6.3 and 7.5. A highly capable candidate typically scores around 6.5.
Number of hours until the interview link expires. After this period, the
interviewUrl is no longer accessible (e.g., 48 for a 48-hour window, 72 for 72 hours).Example Request
Response
A successful201 Created response returns the following fields:
The unique identifier for this interview session (e.g.,
"int_a1b2c3d4"). Use this ID to retrieve the interview status or pass it to your ATS.The URL to share with the candidate. Paste this directly into your outreach email — the candidate opens it in their browser to begin the interview (e.g.,
"https://techeval.ai/interview/int_a1b2c3d4").ISO 8601 timestamp indicating when the interview link will expire, calculated from
deadline_hours (e.g., "2025-09-15T14:30:00Z").Error Codes
One credit is consumed when the candidate begins the interview, not when you create the session. Cancelling or letting a link expire does not deduct any credits from your account.