start_interview
Start a live or mock interview for the user and return the interview page link for the user to open in a browser (web only; it does not launch the desktop app; the user must be signed in to the same account in that browser). Live: the user shares the meeting tab with audio as prompted and, after clicking "Start interview", minutes are deducted by time online. Mock: one mock interview credit is deducted on creation. Only one session of each type can be in progress. Advanced settings not given (answer style, custom instructions, translation, answer recording, web search, knowledge bases) follow the user's saved interview preferences. Target IDs come from list_interview_targets, resume IDs from list_resumes. Uses the user's minutes or credits or creates a payment; tell the user what it costs and get their agreement first. (Requires the user's sign-in with scope interviews:write.)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"targetId": "<targetId>",
"resumeId": "<resumeId>"
},
"name": "start_interview"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Interview language (selects the speech recognition model); omit to use the user's preference | |
| mode | No | Live only: online = video meeting (captures meeting audio), phone = phone interview (speakerphone picked up by the microphone; needs an enrolled voiceprint; Chinese / Cantonese / English only) | online |
| type | No | INTERVIEW = live interview, MOCK_INTERVIEW = mock interview | INTERVIEW |
| focus | No | Mock only: what this session should focus on | |
| round | No | Live only: which round this is for the target | |
| resumeId | Yes | Resume ID | |
| targetId | Yes | Target ID | |
| skipIntro | No | Mock only: skip the self-introduction | |
| assistMode | No | Mock only: turn on AI assist (a suggested answer for each question) | |
| difficulty | No | Mock only: seniority level | FRESH_GRADUATE |
| extraLangs | No | Live only: other languages the user may switch to during the interview; omit to use the user's preference | |
| basicsRatio | No | Mock only: share of fundamentals questions, 0–100; omit to let the AI decide | |
| questionCount | No | Mock only: number of questions; omit to let the AI decide | |
| knowledgeBaseIds | No | Knowledge base IDs; for live interviews omit to use the user's preference; for mock interviews they apply only with AI assist on |