Previous value: -"OPTIONAL. Omit this field entirely and the interview's questions are left exactly as they are — questions are only touched when you send the array. When you do send it, send the COMPLETE list you want the interview to end up with, in order, in the same format create_interview accepts and get_interview_definition returns: there is no way to change a single question on its own, so read the interview, edit that array, and send the whole thing back. An empty array is rejected. It is applied as a DIFF, not a replace, so resending the array get_interview_definition gave you changes nothing at all. Each entry is matched against what is stored — first on `external_id`, then on `id`, then on identical content — and: an entry matching an unchanged question keeps that question exactly as it is, including its answer rules and any rendered avatar video; an entry matching a question whose content differs unlinks the old question and creates a new one in its place (fields you omit are carried over from the old one); an entry matching nothing is created; and a stored question no entry matches is unlinked. Questions are shared records, so nothing is ever deleted — removing one only unlinks it from this interview, and an edit is always unlink-old + create-new so the change cannot leak into another interview reusing the same question. Single-stage interviews only; for a multi-stage position, update its interview stages individually."New value: +"OPTIONAL. Omit this field entirely and the interview's questions are left exactly as they are — questions are only touched when you send the array. When sent, it is the COMPLETE list you want the interview to end up with, in order, in the same format create_interview accepts and get_interview_definition returns: there is no way to change a single question on its own: the array get_interview_definition returns is edited and sent back whole. An empty array is rejected. It is applied as a DIFF, not a replace, so resending the array get_interview_definition gave you changes nothing at all. Each entry is matched against what is stored — first on `external_id`, then on `id`, then on identical content — and: an entry matching an unchanged question keeps that question exactly as it is, including its answer rules and any rendered avatar video; an entry matching a question whose content differs unlinks the old question and creates a new one in its place (fields you omit are carried over from the old one); an entry matching nothing is created; and a stored question no entry matches is unlinked. Questions are shared records, so nothing is ever deleted — removing one only unlinks it from this interview, and an edit is always unlink-old + create-new so the change cannot leak into another interview reusing the same question. Single-stage interviews only; a multi-stage position's interview stages are updated individually."

Previous value: -"A recruiter may hold the interview instead of the AI. Single-stage interviews only (an interview step of a position carries its own setting, see merchant-position-step-update)."New value: +"A recruiter may hold the interview instead of the AI. Single-stage interviews only (an interview step of a position carries its own setting, see update_position_step)."

Previous value: -"Coaching-plan stage this item belongs to, used by the coaching-plan progress view. Omit to keep the current stage. A null is ignored: use `other` when no stage fits."New value: +"Coaching-plan stage this item belongs to, used by the coaching-plan progress view. Omit to keep the current stage. A null is ignored: use `other` when no stage fits. Values: `demo`: Demo session | `screening`: Screening-interview practice | `2nd`: Second-interview practice | `3rd`: Third-interview practice | `closing`: Closing / salary-negotiation practice | `job-specific`: Job-specific coaching | `other`: Anything that does not fit the other buckets."

Previous value: -"Which countries the interview / position is open to on the candidate portal, judged by the IP address the candidate opens it from (an unknown location only passes when countries_allowed / countries_allowed_eu are empty). From a closed country it is left out of the portal listings, and a direct link shows \"not available in your region\". Invited candidates (register_users / invite links) and candidates who already started keep access; API and MCP calls themselves are never restricted. An empty object {} = not used, every country."New value: +"Which countries the interview / position is open to on the candidate portal, judged by the IP address the candidate opens it from (an unknown location only passes when countries_allowed / countries_allowed_eu are empty). From a closed country it is left out of the portal listings, and a direct link shows \"not available in your region\". Invited candidates (personal invitation links) and candidates who already started keep access; API and MCP calls themselves are never restricted. An empty object {} = not used, every country."

Previous value: -"Long-form interview description (column `interview_description_long`)."New value: +"Long-form interview description."

Previous value: -"Which of your webhook environments results from this interview are delivered to. Defaults to production."New value: +"Which of your webhook environments results from this interview are delivered to. Defaults to production. Values: `production`: Live hiring | `uat`: User-acceptance testing - an isolated environment for pre-release verification | `development`: Development/testing | `demo`: Demonstrations and sales trials."

Previous value: -"ISO date/time after which the interview is no longer available to candidates. An empty string keeps it always available."New value: +"ISO date/time after which the interview is no longer available to candidates. An empty string makes it always available."

Previous value: -"Conversation pace of the AI avatar. Omit to keep the current pace; `normal` is the default speaking pace."New value: +"Conversation pace of the AI avatar. Omit to keep the current pace; `normal` is the default speaking pace. Values: `slower`: The avatar speaks more slowly | `normal`: Default speaking pace | `faster`: The avatar speaks more quickly for a snappier conversation | `fluent`: Talking pace: the avatar answers 300 ms after the candidate stops speaking."

Previous value: -"Id of the interview template (avatar/voice) to use. Must reference an existing interview_templates row."New value: +"Id of the interview template (avatar/voice) to use."

Previous value: -"Tone — configures the AI avatar's speaking style and the follow-up questions it generates. Case-insensitive; omit to default to relaxed."New value: +"Tone — configures the AI avatar's speaking style and the follow-up questions it generates. Case-insensitive; omit to keep the current tone. Values: `relaxed`: Friendly and conversational tone that helps candidates feel at ease | `simple`: Plain language at CEFR A2 level | `professional`: Formal and business-like approach suitable for senior roles | `persuasive`: Engaging style that encourages candidates to elaborate | `exact`: Asks the questions exactly as provided, without rephrasing."

Previous value: -"Interview style — configures the AI avatar and the follow-up questions it generates during the interview."New value: +"Interview style — configures the AI avatar and the follow-up questions it generates during the interview. Values: `pre-screening`: quick qualification check focusing on basic requirements and availability | `pre-screening-with-test-questions`: pre-screening plus practical questions to test relevant skills | `second-interview`: deeper dive for candidates who passed initial screening | `remote-freelancer-verification`: verify remote work capabilities and communication skills | `strength-based-interview`: focus on what candidates enjoy and excel at to predict job satisfaction | `potential-based-interview`: assess learning ability and growth potential rather than past experience | `process-verification-from-knowledge-base`: generate questions from your knowledge base documents | `knockout-screening`: a short (about 5 minute) check of the role's must-haves with closed questions."

Previous value: -"Interview location (column `interview_location`). Blank is stored as null."New value: +"Interview location. Blank is stored as null."

Previous value: -"OPTIONAL. Omit this field entirely and the interview's questions are left exactly as they are — this endpoint only touches questions when you send the array. When you do send it, send the COMPLETE list you want the interview to end up with, in order, in the same format job-interview-create-from-array accepts and job-interview-get returns: there is no way to change a single question on its own, so read the interview, edit that array, and send the whole thing back. An empty array is rejected. It is applied as a DIFF, not a replace, so resending the array job-interview-get gave you changes nothing at all. Each entry is matched against what is stored — first on `external_id`, then on `id`, then on identical content — and: an entry matching an unchanged question keeps that question exactly as it is, including its answer rules and any rendered avatar video; an entry matching a question whose content differs unlinks the old question and creates a new one in its place (fields you omit are carried over from the old one); an entry matching nothing is created; and a stored question no entry matches is unlinked. Questions are shared records, so nothing is ever deleted — removing one only unlinks it from this interview, and an edit is always unlink-old + create-new so the change cannot leak into another interview reusing the same question. Single-stage interviews only; for a multi-stage position, update its interview stages individually."New value: +"OPTIONAL. Omit this field entirely and the interview's questions are left exactly as they are — questions are only touched when you send the array. When you do send it, send the COMPLETE list you want the interview to end up with, in order, in the same format create_interview accepts and get_interview_definition returns: there is no way to change a single question on its own, so read the interview, edit that array, and send the whole thing back. An empty array is rejected. It is applied as a DIFF, not a replace, so resending the array get_interview_definition gave you changes nothing at all. Each entry is matched against what is stored — first on `external_id`, then on `id`, then on identical content — and: an entry matching an unchanged question keeps that question exactly as it is, including its answer rules and any rendered avatar video; an entry matching a question whose content differs unlinks the old question and creates a new one in its place (fields you omit are carried over from the old one); an entry matching nothing is created; and a stored question no entry matches is unlinked. Questions are shared records, so nothing is ever deleted — removing one only unlinks it from this interview, and an edit is always unlink-old + create-new so the change cannot leak into another interview reusing the same question. Single-stage interviews only; for a multi-stage position, update its interview stages individually."

Previous value: -"Cheating/proctoring detection mode for candidate answers — this is NOT a full session recording. Omit to keep the current setting. A null is ignored: turn it off in the admin console."New value: +"Cheating/proctoring detection mode for candidate answers — this is NOT a full session recording. Omit to keep the current mode; `none` switches it off; a null is ignored. Values: `audio_first_5_answers`: Audio-only cheating detection, first 5 answers only | `audio_all`: Audio-only cheating detection on every answer | `video_all`: Audio + video cheating detection on every answer | `video_first_5_answers`: Audio + video cheating detection, first 5 answers only | `none`: Switch cheating detection off."

Previous value: -[
-  "audio_first_5_answers",
-  "audio_all",
-  "video_all",
-  "video_first_5_answers",
-  null
-]New value: +[
+  "audio_first_5_answers",
+  "audio_all",
+  "video_all",
+  "video_first_5_answers",
+  "none",
+  null
+]

Previous value: -"Full interview-session recording (includes the avatar and voice) produced as a single file. Omit to keep the current setting. A null is ignored: turn it off in the admin console."New value: +"Full interview-session recording (includes the avatar and voice) produced as a single file. Omit to keep the current setting; `none` switches it off; a null is ignored. Values: `audio_all`: Record the whole session audio | `video_all`: Record the whole session video + audio | `none`: Switch the full-session recording off."

Previous value: -[
-  "audio_all",
-  "video_all",
-  null
-]New value: +[
+  "audio_all",
+  "video_all",
+  "none",
+  null
+]

Previous value: -"Profile id of the recruiter owning this interview or position (profile.id). Must be an active owner, recruiter or admin of the company (own staff or a sub-merchant grant holder), else 422. An empty string clears it."New value: +"Profile id of the recruiter owning this interview or position (`profile_id` (list_users)). Must be an active owner, recruiter or admin of the company (own staff or a sub-merchant grant holder), else 422. An empty string clears it."

Previous value: -"Re-derive the interview-level `candidate_expectations_json` scoring rubric from the resulting question list, the way job-interview-create-from-array derives it at creation time. Only applies when `questions` is sent, the interview type is `interview`, and `candidate_expectations_json` is not also being set explicitly (an explicit value wins)."New value: +"Re-derive the interview-level `candidate_expectations_json` scoring rubric from the resulting question list, the way create_interview derives it at creation time. Only applies when `questions` is sent, the interview type is `interview`, and `candidate_expectations_json` is not also being set explicitly (an explicit value wins)."

Previous value: -"Result screen shown to the candidate after finishing. With any value other than `none`, the candidate sees a results screen where they can provide feedback, record an intro video and edit the transcript, and must then submit the result; the value sets how much score/result detail is shown."New value: +"Result screen shown to the candidate after finishing. With any value other than `none`, the candidate sees a results screen where they can provide feedback, record an intro video and edit the transcript, and must then submit the result; the value sets how much score/result detail is shown. Values: `none`: No results screen at all | `minimal`: Minimal results layout, no score shown | `minimal_with_score`: Minimal results layout including the overall score | `advanced`: Advanced results layout with more detail | `full`: Full results layout with all sections | `full_expand_scores`: Full results with every score breakdown expanded."

Previous value: -"Target seniority level for the role; auto-detected from the job description when omitted."New value: +"Target seniority level for the role; omit to keep the current one. Values: `entry-level`: Early-career or graduate roles | `intermediate`: Some experience required | `senior`: Experienced professional | `managerial`: Team or department lead | `director`: Director-level responsibility | `executive`: C-suite or executive role."

Previous value: -"New publication status (type_interview_status). Refused (422) for the AI interview step of a multi-stage position (visibility sub_item): its status follows the position."New value: +"New publication status (preparing and completed are normally set by the platform), applied exactly as set_interview_state applies it: archiving an active position e-mails its candidates with open applications when the position-closed notice is on (set_interview_state previews that with dry_run, and also manages the iframe embed key and the vacancy lifecycle of a position). Refused (422) for the AI interview step of a multi-stage position: its status follows the position."

Previous value: -"Free-form tags stored on the interview. Only `active` sessions with visibility `public` or `merchant_public` are listed."New value: +"Free-form tags stored on the interview. Only `active` sessions with visibility `merchant_public` (or the platform's own `public`) are listed."

Previous value: -"Credit bucket the session draws from. Only meaningful for candidate-paid coaching/persona sessions; hiring interviews and assessments are merchant-billed and carry null."New value: +"Credit bucket the session draws from. Only meaningful for candidate-paid coaching/persona sessions; hiring interviews and assessments are merchant-billed and carry null. Values: `resume_check`: Resume Builder credits | `interview_coach_starter`: starter tier | `interview_coach_contributor`: contributor tier | `interview_coach_manager`: manager tier | `cover_letter`: Cover-letter credits."

Previous value: -"Who can discover and access the interview. Refused (422) for the AI interview step of a multi-stage position (visibility sub_item): it follows the position."New value: +"Who can discover and access the interview. Refused (422) for the AI interview step of a multi-stage position: it follows the position. Values: `merchant_public`: Listed on the merchant's public interview list | `merchant_invite`: only candidates explicitly invited | `merchant_unlisted`: Reachable only via a direct link."

Previous value: -"Structured candidate expectations (the scoring rubric), bucketed by requirement level (weak/moderate/strong). A null is ignored: send a new rubric to replace it, or regenerate_candidate_expectations together with `questions` to derive it again. Extra keys are preserved."New value: +"Structured candidate expectations (the scoring rubric), bucketed by requirement level (weak/moderate/strong). A null is ignored: send a new rubric to replace it, or regenerate_candidate_expectations together with `questions` to derive it again."

Removed value: -"Requirements expected of a solid, competent candidate."

Removed value: -"High-bar requirements only standout candidates clear."

Removed value: -"Baseline requirements every viable candidate should meet (table stakes)."

Previous value: -"SMS / WhatsApp notifications to the candidate, sent alongside the e-mails: \"reminders\" = with both e-mail reminders (day 1 and day 3); \"last_reminder\" = only with the final day-3 reminder; \"all\" = invitation, both reminders and the pre-screening-accepted step. null switches them off. WhatsApp is tried first, SMS when the number is not on WhatsApp. Available on paid plans (Starter and above) and needs a phone number on the candidate."New value: +"SMS / WhatsApp notifications to the candidate, sent alongside the e-mails: \"reminders\" = with both e-mail reminders (day 1 and day 3); \"last_reminder\" = only with the final day-3 reminder; \"all\" = invitation, both reminders and the pre-screening-accepted step. null switches them off."

Previous value: -"Coaching-plan stage this item belongs to, used by the coaching-plan progress view. Omit to keep the current stage. A null is ignored: use `other` when no stage fits. Options — `demo`: Demo session. | `screening`: Screening-interview practice. | `2nd`: Second-interview practice. | `3rd`: Third-interview practice. | `closing`: Closing / salary-negotiation practice. | `job-specific`: Job-specific coaching. | `other`: Anything that does not fit the other buckets.."New value: +"Coaching-plan stage this item belongs to, used by the coaching-plan progress view. Omit to keep the current stage. A null is ignored: use `other` when no stage fits."

Removed value: -"screening"

Removed value: -"Available ONLY to candidates in these countries (ISO 3166-1 alpha-2)."

Removed value: -[
-  "PH",
-  "IN"
-]

Removed value: -"Adds every EU country (plus EEA and Switzerland) to countries_allowed."

Removed value: -"NOT available to candidates in these countries (ISO 3166-1 alpha-2). Wins over the allowed side."

Removed value: -[
-  "US"
-]

Removed value: -"Adds every EU country (plus EEA and Switzerland) to countries_blocked."

Previous value: -"Company-defined position fields to set, {key: value}; a null value clears that field and keys you omit keep their value. Values are checked against the field definitions (option values, YYYY-MM-DD dates, {min, max, currency} ranges, user profile ids). Requires custom fields to be enabled for the company (else 403). Multi-stage positions only: on a single-stage interview the request is refused with 422."New value: +"Company-defined position fields to set, {key: value}; a null value clears that field and keys you omit keep their value. Requires custom fields to be enabled for the company (else 403). Multi-stage positions only: on a single-stage interview the request is refused with 422."

Removed value: -{
-  "contract_type": "permanent",
-  "cost_centre": "CC-100"
-}

Previous value: -"Long-form interview description (column `interview_description_long`). Rendered as Markdown on the candidate-facing position page, including chips, callouts, cards, columns and buttons — formatting guide: https://developer.jobmojito.com/cookbooks/format-content-with-markdown"New value: +"Long-form interview description (column `interview_description_long`)."

Previous value: -"Emoji marker shown in the admin lists. Interviews and positions. Blank is stored as null."New value: +"Emoji marker shown in the admin lists. Blank is stored as null."

Previous value: -"Which of your webhook environments results from this interview are delivered to. Defaults to production. Options — `production`: Live hiring. Results reach the webhooks configured as production. This is the default when the field is omitted. | `uat`: User-acceptance testing - an isolated environment for pre-release verification. | `development`: Development/testing. Use for interviews created by a test or preview app so their results never reach the production webhook. | `demo`: Demonstrations and sales trials.."New value: +"Which of your webhook environments results from this interview are delivered to. Defaults to production."

Removed value: -"production"

Previous value: -"Who the position is really for. An object with name null/blank means hiring for yourself; { name: 'undisclosed' } for an unnamed external client; or { name: '<company>' } plus optional description/location/sector/company_size. Stored in creation_parameters.hiring_for_company."New value: +"Who the position is really for. An object with name null/blank means hiring for yourself; { name: 'undisclosed' } for an unnamed external client; or { name: '<company>' } plus optional description/location/sector/company_size."

Removed value: -{
-  "name": "undisclosed"
-}

Removed value: -"Approximate headcount of the end employer."

Removed value: -"100-200"

Removed value: -"Short description of the end employer, used as background context by the agent."

Removed value: -"Unimo Enterprises is a leading logistics and supply chain solutions provider."

Removed value: -"Primary location of the end employer."

Removed value: -"Sri Lanka"

Removed value: -"End-employer name. Omit/null when hiring for yourself, 'undisclosed' for an unnamed external client, or the client's company name."

Removed value: -"Unimo Enterprises"

Removed value: -"Industry / sector of the end employer."

Removed value: -"Logistics and Supply Chain"

Previous value: -"Allowed candidate attempts (1-20). Stored as result_scoring.max_retries."New value: +"Allowed candidate attempts (1-20)."

Removed value: -1

Removed value: -"2026-12-31"

Previous value: -"Job category shown on public listings above the department (free text), e.g. \"Ashore\". Interviews and positions. Blank is stored as null."New value: +"Job category shown on public listings above the department (free text), e.g. \"Ashore\". Blank is stored as null."

Removed value: -"Ashore"

Previous value: -"Conversation pace of the AI avatar. Omit to keep the current pace; `normal` is the default speaking pace. Options — `slower`: The avatar speaks more slowly — easier to follow for non-native speakers. | `normal`: Default speaking pace. | `faster`: The avatar speaks more quickly for a snappier conversation. | `fluent`: Talking pace: the avatar answers 300 ms after the candidate stops speaking. A pause mid-sentence also ends their turn.."New value: +"Conversation pace of the AI avatar. Omit to keep the current pace; `normal` is the default speaking pace."

Removed value: -"normal"

Removed value: -"Engineering"

Removed value: -"$80k - $100k"

Previous value: -"Id of the interview template (avatar/voice) to use. Must reference an existing interview_templates row. Also decides the modality — see list_avatars / merchant-avatar-list."New value: +"Id of the interview template (avatar/voice) to use. Must reference an existing interview_templates row."

Removed value: -"46b98d37-1557-4391-beca-03037ead19f2"

Previous value: -"Tone — configures the AI avatar's speaking style and the follow-up questions it generates. Stored in creation_parameters; existing questions are NOT regenerated. Case-insensitive; omit to default to relaxed. Options — `relaxed`: Friendly and conversational tone that helps candidates feel at ease. | `simple`: Plain language at CEFR A2 level — short sentences and simple words. | `professional`: Formal and business-like approach suitable for senior roles. | `persuasive`: Engaging style that encourages candidates to elaborate. | `exact`: Asks the questions exactly as provided, without rephrasing — for interviews built from your own questions (create_interview_from_questions) where the wording is a script.."New value: +"Tone — configures the AI avatar's speaking style and the follow-up questions it generates. Case-insensitive; omit to default to relaxed."

Removed value: -"professional"

Previous value: -"Interview style — configures the AI avatar and the follow-up questions it generates during the interview. Stored in creation_parameters; existing questions are NOT regenerated. Options — `pre-screening`: Pre-screening — quick qualification check focusing on basic requirements and availability. | `pre-screening-with-test-questions`: Pre-screening with test questions — pre-screening plus practical questions to test relevant skills. | `second-interview`: Second round interview — deeper dive for candidates who passed initial screening. | `remote-freelancer-verification`: Remote worker verification — verify remote work capabilities and communication skills. | `strength-based-interview`: Strength-based interview — focus on what candidates enjoy and excel at to predict job satisfaction. | `potential-based-interview`: Potential-based interview — assess learning ability and growth potential rather than past experience. | `process-verification-from-knowledge-base`: Knowledge Base interview — generate questions from your knowledge base documents. | `knockout-screening`: Knock-out screening — a short (about 5 minute) check of the role's must-haves with closed questions; ends early, politely, when a must-have is clearly not met. On creation it defaults custom_scoring.early_stop to true (where the avatar supports early stop) and max_followups to 1 unless you send them.."New value: +"Interview style — configures the AI avatar and the follow-up questions it generates during the interview."

Removed value: -"pre-screening-with-test-questions"

Added value: +{
+  "description": "Your model id, e.g. \"claude-opus-4-8\"; \"unknown\" if unsure. For analytics.",
+  "type": "string"
+}

Removed value: -"remote"

Previous value: -"Live session limit in seconds. Also the basis for the credit multiplier."New value: +"Live session limit in seconds."

Removed value: -1200

Removed value: -2

Removed value: -"Project manager"

Removed value: -"Include the AI recruiter assessment."

Removed value: -"Include the AI scoring rubric."

Removed value: -"Include analytics."

Removed value: -"Include per-answer recordings."

Removed value: -"Include candidate contact details."

Removed value: -"Include uploaded candidate files."

Removed value: -"Group transcript answers by expected question."

Removed value: -"Report language code (a platform-languages.json code)."

Removed value: -"en"

Removed value: -"Include the full-session recording."

Removed value: -"Report layout: classic, modern, or one_pager. Omit for the merchant default (modern when unset)."

Removed value: -"Include the interview transcript."

Previous value: -"Id of the interview definition (single-stage) or position definition (multi-stage) to update. The same id you pass to job-interview-get."New value: +"Id of the interview definition (single-stage) or position definition (multi-stage) to update."

Removed value: -"00000000-0000-0000-0000-000000000000"

Previous value: -"OPTIONAL. Omit this field entirely and the interview's questions are left exactly as they are — this endpoint only touches questions when you send the array. When you do send it, send the COMPLETE list you want the interview to end up with, in order, in the same format job-interview-create-from-array accepts and job-interview-get returns: there is no way to change a single question on its own, so read the interview, edit that array, and send the whole thing back. An empty array is rejected. It is applied as a DIFF, not a replace, so resending the array job-interview-get gave you changes nothing at all. Each entry is matched against what is stored — first on `external_id`, then on `id`, then on identical content — and: an entry matching an unchanged question keeps that question exactly as it is, including its answer rules and any rendered avatar video; an entry matching a question whose content differs unlinks the old question and creates a new one in its place (fields you omit are carried over from the old one); an entry matching nothing is created; and a stored question no entry matches is unlinked. `questions_diff` in the response reports exactly what was decided. Questions are shared records, so nothing is ever deleted — removing one only unlinks it from this interview, and an edit is always unlink-old + create-new so the change cannot leak into another interview reusing the same question. The welcome, thank-you and instructional-video steps are not part of this array and are left in place. Single-stage interviews only; for a multi-stage position, update its interview stages individually."New value: +"OPTIONAL. Omit this field entirely and the interview's questions are left exactly as they are — this endpoint only touches questions when you send the array. When you do send it, send the COMPLETE list you want the interview to end up with, in order, in the same format job-interview-create-from-array accepts and job-interview-get returns: there is no way to change a single question on its own, so read the interview, edit that array, and send the whole thing back. An empty array is rejected. It is applied as a DIFF, not a replace, so resending the array job-interview-get gave you changes nothing at all. Each entry is matched against what is stored — first on `external_id`, then on `id`, then on identical content — and: an entry matching an unchanged question keeps that question exactly as it is, including its answer rules and any rendered avatar video; an entry matching a question whose content differs unlinks the old question and creates a new one in its place (fields you omit are carried over from the old one); an entry matching nothing is created; and a stored question no entry matches is unlinked. Questions are shared records, so nothing is ever deleted — removing one only unlinks it from this interview, and an edit is always unlink-old + create-new so the change cannot leak into another interview reusing the same question. Single-stage interviews only; for a multi-stage position, update its interview stages individually."

Removed value: -"Per-question candidate expectations, bucketed by requirement level (weak/moderate/strong). Extra keys are preserved."

Removed value: -"Requirements expected of a solid, competent candidate."

Removed value: -"High-bar requirements only standout candidates clear."

Removed value: -"Baseline requirements every viable candidate should meet (table stakes)."

Removed value: -"With conditional_question_main_id: the answer to the yes/no question that shows this follow-up. `true` (the default) asks it after a yes, `false` after a no, so each answer can lead to its own follow-ups. Ignored on a question without conditional_question_main_id."

Removed value: -false

Removed value: -"For a follow-up question, the id (the \"id\" field above) of the yes/no question (is_conditional) in this same array that decides whether it is asked. The yes/no question must appear earlier in the array. Use conditional_question_answer to choose the answer that shows it."

Removed value: -"Answer duration in seconds for this question."

Removed value: -"Arbitrary JSON metadata stored on the question."

Removed value: -"External identifier stored on the question. job-interview-update matches on this first, so an ATS that owns stable ids can send its own array and have the diff line up without round-tripping our ids."

Removed value: -"Identifier for this question. job-interview-get returns the question's real id here; send it back to job-interview-update so an unchanged question keeps its existing record (and with it its answer rules and any rendered avatar video). Also the handle another question references via conditional_question_main_id. On job-interview-create-from-array it is a caller-local value, only needed for those references."

Removed value: -"Candidate-asks-recruiter prompt (view 'candidate asking recruiter')."

Removed value: -"A yes/no question that decides which follow-ups are asked (view 'with listening conditional'). Its follow-ups point at it with conditional_question_main_id."

Removed value: -"Expert listening question (view 'with listening expert')."

Removed value: -"Multiple-choice question (view 'multiple choice')."

Removed value: -"The candidate may skip this question: the recorded (offline avatar) interview shows a Skip button on it, and a skipped question is saved without an answer. Defaults to false."

Removed value: -false

Removed value: -"Question is asked but not scored (view 'without scoring')."

Removed value: -"Knowledge-base store id (uuid) the question draws context from."

Removed value: -"Optional label/tag stored on the question."

Removed value: -"Per-question language override (one of the platform-languages.json codes). Inherits the interview language when omitted."

Removed value: -"en"

Removed value: -"The question text shown to the candidate."

Removed value: -"Alternative phrasings for the question."

Removed value: -0.5

Previous value: -"Cheating/proctoring detection mode for candidate answers — this is NOT a full session recording. Video options also record the candidate. Omit to keep the current setting. A null is ignored: turn it off in the admin console. Options — `audio_first_5_answers`: Audio-only cheating detection, first 5 answers only. | `audio_all`: Audio-only cheating detection on every answer. | `video_all`: Audio + video cheating detection on every answer (candidate is recorded for all answers). | `video_first_5_answers`: Audio + video cheating detection, first 5 answers only.."New value: +"Cheating/proctoring detection mode for candidate answers — this is NOT a full session recording. Omit to keep the current setting. A null is ignored: turn it off in the admin console."

Removed value: -"video_all"

Previous value: -"Full interview-session recording (includes the avatar and voice) produced as a single file. Independent of `recording`. Omit to keep the current setting. A null is ignored: turn it off in the admin console. Options — `audio_all`: Record the whole session audio (avatar + candidate voice) into a single file. Adds +0.2 credits. | `video_all`: Record the whole session video + audio (avatar + candidate) into a single file. Adds +0.4 credits.."New value: +"Full interview-session recording (includes the avatar and voice) produced as a single file. Omit to keep the current setting. A null is ignored: turn it off in the admin console."

Removed value: -"video_all"

Removed value: -false

Previous value: -"Result screen shown to the candidate after finishing. With any value other than `none`, the candidate sees a results screen where they can provide feedback, record an intro video and edit the transcript, and must then submit the result; the value sets how much score/result detail is shown. Options — `none`: No results screen at all — the interview is submitted immediately when the candidate finishes (no feedback, intro video, transcript edit or manual submit step). | `minimal`: Minimal results layout, no score shown. | `minimal_with_score`: Minimal results layout including the overall score. | `advanced`: Advanced results layout with more detail. | `full`: Full results layout with all sections. | `full_expand_scores`: Full results with every score breakdown expanded.."New value: +"Result screen shown to the candidate after finishing. With any value other than `none`, the candidate sees a results screen where they can provide feedback, record an intro video and edit the transcript, and must then submit the result; the value sets how much score/result detail is shown."

Removed value: -"full"

Previous value: -"Target seniority level for the role; auto-detected from the job description when omitted. Options — `entry-level`: Early-career or graduate roles. | `intermediate`: Some experience required. | `senior`: Experienced professional. | `managerial`: Team or department lead. | `director`: Director-level responsibility. | `executive`: C-suite or executive role.."New value: +"Target seniority level for the role; auto-detected from the job description when omitted."

Removed value: -"senior"

Previous value: -"New publication status (type_interview_status). Applied through the same interview_set_status routine as job-interview-set-state (which is also where you manage the iframe embed key and the vacancy lifecycle of a position). Refused (422) for the AI interview step of a multi-stage position (visibility sub_item): its status follows the position."New value: +"New publication status (type_interview_status). Refused (422) for the AI interview step of a multi-stage position (visibility sub_item): its status follows the position."

Removed value: -"active"

Previous value: -"Free-form tags stored on the interview. Tags are also the coaching-catalogue mapping key: a catalogue directory (see the catalogue-tag-create / catalogue-tag-update endpoints) lists a coaching or persona session when the session's tags contain EVERY tag in that directory's `tags_interview_set_filter`. Only `active` sessions with visibility `public` or `merchant_public` are listed."New value: +"Free-form tags stored on the interview. Only `active` sessions with visibility `public` or `merchant_public` are listed."

Removed value: -[
-  "interview-practice",
-  "sales"
-]

Previous value: -"Multi-stage positions only (422 on an interview): the complete hiring team you want, replacing the current members (viewers, managed with position access, are kept). An empty array removes everyone. Needs the hiring team switched on for the company (else 403) and access to the position. Each member is a person (profile_id: an active or invited staff user of the company) or a group (profile_group_id), with a role. The answer carries the resulting `team`."New value: +"Multi-stage positions only (422 on an interview): the complete hiring team you want, replacing the current members (viewers, managed with position access, are kept). An empty array removes everyone. Needs the hiring team switched on for the company (else 403) and access to the position."

Removed value: -[
-  {
-    "profile_id": "00000000-0000-0000-0000-000000000001",
-    "role": "interviewer"
-  }
-]

Removed value: -"A group of the company (profile_group.id)."

Removed value: -"A person: an active or invited staff user of the company (profile.id)."

Removed value: -"Role on the hiring team."

Removed value: -"interview"

Previous value: -"Credit bucket the session draws from. Only meaningful for candidate-paid coaching/persona sessions; hiring interviews and assessments are merchant-billed and carry null. Options — `resume_check`: Resume-check credits. | `interview_coach_starter`: Coaching credits — starter tier. | `interview_coach_contributor`: Coaching credits — contributor tier. | `interview_coach_manager`: Coaching credits — manager tier. | `cover_letter`: Cover-letter credits.."New value: +"Credit bucket the session draws from. Only meaningful for candidate-paid coaching/persona sessions; hiring interviews and assessments are merchant-billed and carry null."

Removed value: -"interview_coach_manager"

Previous value: -"Who can discover and access the interview. Refused (422) for the AI interview step of a multi-stage position (visibility sub_item): it follows the position. Options — `merchant_public`: Listed on the merchant's public interview list — anyone with the merchant link can find and start it. | `merchant_invite`: Invite-only — only candidates explicitly invited (by email/link) can access it; not listed anywhere. | `merchant_unlisted`: Reachable only via a direct link — not listed anywhere; share the link manually.."New value: +"Who can discover and access the interview. Refused (422) for the AI interview step of a multi-stage position (visibility sub_item): it follows the position."

Removed value: -"merchant_public"

Removed value: -"Confirmation of what was updated."

Removed value: -"True when the id resolved to a multi-stage position (position_def_set) rather than a single interview."

Removed value: -"The id that was updated."

Removed value: -"What the question diff decided, question by question. Absent when `questions` was not sent."

Removed value: -"Ids of the questions created for entries that matched nothing stored."

Removed value: -"Questions left exactly as they were, record and all."

Removed value: -"The interview's full ordered step list after the update, including the welcome / thank-you / instructional steps this endpoint does not manage."

Removed value: -"True when the interview was already active and was re-published so the new questions go live."

Removed value: -"Ids unlinked because no entry in the request matched them. The question records themselves still exist."

Removed value: -"Edited questions: the old record was unlinked and a new one created, so the change cannot leak into other interviews reusing it."

Removed value: -"The id that was unlinked."

Removed value: -"The id of the question created in its place."

Previous value: -[
-  {
-    "description": "include=team (multi-stage positions): the hiring team.",
-    "properties": {
-      "enabled": {
-        "description": "Whether the company has the hiring team switched on (switch hiring_team); members is empty while it is off.",
-        "type": [
-          "boolean",
-          "null"
-        ]
-      },
-      "members": {
-        "description": "Members by role, then name.",
-        "items": {
-          "properties": {
-            "email": {
-              "description": "E-mail of a person.",
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "group_member_count": {
-              "description": "People in a group (with its subgroups).",
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "group_name": {
-              "description": "Group name.",
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "id": {
-              "description": "Membership id (position_team.id).",
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "name": {
-              "description": "Person or group name.",
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "profile_group_id": {
-              "description": "A group (profile_group.id); null for a person.",
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "profile_id": {
-              "description": "A person (profile.id); null for a group.",
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "role": {
-              "description": "Role on the hiring team.",
-              "enum": [
-                "recruiter",
-                "sourcer",
-                "coordinator",
-                "hiring_manager",
-                "interviewer",
-                "viewer",
-                null
-              ],
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "required": [
-            "id",
-            "role",
-            "profile_id",
-            "profile_group_id",
-            "name",
-            "email",
-            "group_name",
-            "group_member_count"
-          ],
-          "type": "object"
-        },
-        "type": [
-          "array",
-          "null"
-        ]
-      },
-      "owner": {
-        "description": "The position's recruiter (recruiter_profile_id); null when none.",
-        "properties": {
-          "email": {
-            "description": "E-mail.",
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "name": {
-            "description": "Name.",
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "profile_id": {
-            "description": "Owning recruiter (profile.id).",
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "profile_id",
-          "name",
-          "email"
-        ],
-        "type": [
-          "object",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "enabled",
-      "owner",
-      "members"
-    ],
-    "type": "object"
-  },
-  {
-    "description": "The hiring team after the change. Absent when `team` was not sent."
-  }
-]New value: +[
+  {
+    "properties": {
+      "enabled": {
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "members": {
+        "items": {
+          "properties": {
+            "email": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "group_member_count": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "group_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "profile_group_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "profile_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "role": {
+              "enum": [
+                "recruiter",
+                "sourcer",
+                "coordinator",
+                "hiring_manager",
+                "interviewer",
+                "viewer",
+                null
+              ],
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "id",
+            "role",
+            "profile_id",
+            "profile_group_id",
+            "name",
+            "email",
+            "group_name",
+            "group_member_count"
+          ],
+          "type": "object"
+        },
+        "type": [
+          "array",
+          "null"
+        ]
+      },
+      "owner": {
+        "properties": {
+          "email": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "profile_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "profile_id",
+          "name",
+          "email"
+        ],
+        "type": [
+          "object",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "enabled",
+      "owner",
+      "members"
+    ],
+    "type": "object"
+  },
+  {}
+]

Removed value: -"Names of the stored columns that were written, plus `status` when the publication status was changed, `questions` when the question list was diffed, `custom_fields` and `team` when those were set."

Removed value: -[
-  "name",
-  "tags"
-]

Added value: +{
+  "description": "A recruiter may hold the interview instead of the AI. Single-stage interviews only (an interview step of a position carries its own setting, see merchant-position-step-update).",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Ask the candidate for a resume / cover letter: hidden, optional or required. Single-stage interviews only.",
+  "enum": [
+    "hidden",
+    "optional",
+    "required"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Emoji marker shown in the admin lists. Interviews and positions. Blank is stored as null.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Job category shown on public listings above the department (free text), e.g. \"Ashore\". Interviews and positions. Blank is stored as null.",
+  "example": "Ashore",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -"Profile id of the recruiter owning this interview. Must be a merchant/merchant_owner/admin profile of the same merchant. An empty string clears it."New value: +"Profile id of the recruiter owning this interview or position (profile.id). Must be an active owner, recruiter or admin of the company (own staff or a sub-merchant grant holder), else 422. An empty string clears it."

Previous value: -"New lifecycle status. Applied through the same interview_set_status routine as job-interview-set-state (which is also where you manage the iframe embed key)."New value: +"New publication status (type_interview_status). Applied through the same interview_set_status routine as job-interview-set-state (which is also where you manage the iframe embed key and the vacancy lifecycle of a position). Refused (422) for the AI interview step of a multi-stage position (visibility sub_item): its status follows the position."

Added value: +{
+  "description": "Multi-stage positions only (422 on an interview): the complete hiring team you want, replacing the current members (viewers, managed with position access, are kept). An empty array removes everyone. Needs the hiring team switched on for the company (else 403) and access to the position. Each member is a person (profile_id: an active or invited staff user of the company) or a group (profile_group_id), with a role. The answer carries the resulting `team`.",
+  "example": [
+    {
+      "profile_id": "00000000-0000-0000-0000-000000000001",
+      "role": "interviewer"
+    }
+  ],
+  "items": {
+    "properties": {
+      "profile_group_id": {
+        "description": "A group of the company (profile_group.id).",
+        "format": "uuid",
+        "type": "string"
+      },
+      "profile_id": {
+        "description": "A person: an active or invited staff user of the company (profile.id).",
+        "format": "uuid",
+        "type": "string"
+      },
+      "role": {
+        "description": "Role on the hiring team.",
+        "enum": [
+          "recruiter",
+          "sourcer",
+          "coordinator",
+          "hiring_manager",
+          "interviewer"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "role"
+    ],
+    "type": "object"
+  },
+  "maxItems": 100,
+  "type": "array"
+}

Previous value: -"Who can discover and access the interview. Options — `merchant_public`: Listed on the merchant's public interview list — anyone with the merchant link can find and start it. | `merchant_invite`: Invite-only — only candidates explicitly invited (by email/link) can access it; not listed anywhere. | `merchant_unlisted`: Reachable only via a direct link — not listed anywhere; share the link manually.."New value: +"Who can discover and access the interview. Refused (422) for the AI interview step of a multi-stage position (visibility sub_item): it follows the position. Options — `merchant_public`: Listed on the merchant's public interview list — anyone with the merchant link can find and start it. | `merchant_invite`: Invite-only — only candidates explicitly invited (by email/link) can access it; not listed anywhere. | `merchant_unlisted`: Reachable only via a direct link — not listed anywhere; share the link manually.."

Added value: +{
+  "allOf": [
+    {
+      "description": "include=team (multi-stage positions): the hiring team.",
+      "properties": {
+        "enabled": {
+          "description": "Whether the company has the hiring team switched on (switch hiring_team); members is empty while it is off.",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "members": {
+          "description": "Members by role, then name.",
+          "items": {
+            "properties": {
+              "email": {
+                "description": "E-mail of a person.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "group_member_count": {
+                "description": "People in a group (with its subgroups).",
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "group_name": {
+                "description": "Group name.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "id": {
+                "description": "Membership id (position_team.id).",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "name": {
+                "description": "Person or group name.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "profile_group_id": {
+                "description": "A group (profile_group.id); null for a person.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "profile_id": {
+                "description": "A person (profile.id); null for a group.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "role": {
+                "description": "Role on the hiring team.",
+                "enum": [
+                  "recruiter",
+                  "sourcer",
+                  "coordinator",
+                  "hiring_manager",
+                  "interviewer",
+                  "viewer",
+                  null
+                ],
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "required": [
+              "id",
+              "role",
+              "profile_id",
+              "profile_group_id",
+              "name",
+              "email",
+              "group_name",
+              "group_member_count"
+            ],
+            "type": "object"
+          },
+          "type": [
+            "array",
+            "null"
+          ]
+        },
+        "owner": {
+          "description": "The position's recruiter (recruiter_profile_id); null when none.",
+          "properties": {
+            "email": {
+              "description": "E-mail.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "description": "Name.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "profile_id": {
+              "description": "Owning recruiter (profile.id).",
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "profile_id",
+            "name",
+            "email"
+          ],
+          "type": [
+            "object",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "enabled",
+        "owner",
+        "members"
+      ],
+      "type": "object"
+    },
+    {
+      "description": "The hiring team after the change. Absent when `team` was not sent."
+    }
+  ]
+}

Previous value: -"Names of the stored columns that were written, plus `status` when the lifecycle status was changed and `questions` when the question list was diffed."New value: +"Names of the stored columns that were written, plus `status` when the publication status was changed, `questions` when the question list was diffed, `custom_fields` and `team` when those were set."

Previous value: -"Structured candidate expectations (the scoring rubric), bucketed by requirement level (weak/moderate/strong). null clears the rubric. Extra keys are preserved."New value: +"Structured candidate expectations (the scoring rubric), bucketed by requirement level (weak/moderate/strong). A null is ignored: send a new rubric to replace it, or regenerate_candidate_expectations together with `questions` to derive it again. Extra keys are preserved."

Previous value: -[
-  "array",
-  "null"
-]New value: +"array"

Previous value: -[
-  "array",
-  "null"
-]New value: +"array"

Previous value: -[
-  "array",
-  "null"
-]New value: +"array"

Previous value: -"Whether a candidate video introduction is hidden, optional or required. null is treated like hidden."New value: +"Whether a candidate video introduction is hidden, optional or required. Send `hidden` to stop asking."

Previous value: -"Coaching-plan stage this item belongs to, used by the coaching-plan progress view. Omit/null to leave it out of any plan. Options — `demo`: Demo session. | `screening`: Screening-interview practice. | `2nd`: Second-interview practice. | `3rd`: Third-interview practice. | `closing`: Closing / salary-negotiation practice. | `job-specific`: Job-specific coaching. | `other`: Anything that does not fit the other buckets.."New value: +"Coaching-plan stage this item belongs to, used by the coaching-plan progress view. Omit to keep the current stage. A null is ignored: use `other` when no stage fits. Options — `demo`: Demo session. | `screening`: Screening-interview practice. | `2nd`: Second-interview practice. | `3rd`: Third-interview practice. | `closing`: Closing / salary-negotiation practice. | `job-specific`: Job-specific coaching. | `other`: Anything that does not fit the other buckets.."

Previous value: -"Pass the exact conversation_id from the server's previous response, unchanged. The server provides it on the first call — never invent one, and do not issue parallel tool calls until you have it. Keep passing the same conversation_id for the rest of the conversation, including after later user messages or on a different task; do not reset it when the user starts a new request."New value: +"The conversation_id this server returned earlier in this conversation, unchanged, including after later user messages. Omit it if you have none. Recorded for the server developer's analytics."

Previous value: -"Which countries the interview / position is open to on the candidate portal, judged by the IP address the candidate opens it from (an unknown location only passes when countries_allowed / countries_allowed_eu are empty). From a closed country it is left out of the portal listings, and a direct link shows \"not available in your region\". Invited candidates (register_users / invite links) and candidates who already started keep access; API and MCP calls themselves are never restricted. Null = not used, every country."New value: +"Which countries the interview / position is open to on the candidate portal, judged by the IP address the candidate opens it from (an unknown location only passes when countries_allowed / countries_allowed_eu are empty). From a closed country it is left out of the portal listings, and a direct link shows \"not available in your region\". Invited candidates (register_users / invite links) and candidates who already started keep access; API and MCP calls themselves are never restricted. An empty object {} = not used, every country."

Previous value: -[
-  "array",
-  "null"
-]New value: +"array"

Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"

Previous value: -[
-  "array",
-  "null"
-]New value: +"array"

Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"

Previous value: -[
-  "object",
-  "null"
-]New value: +"object"

Previous value: -[
-  "production",
-  "uat",
-  "development",
-  "demo",
-  null
-]New value: +[
+  "production",
+  "uat",
+  "development",
+  "demo"
+]

Previous value: -[
-  "string",
-  "null"
-]New value: +"string"

Previous value: -"Who the position is really for. null (or an object with name null/blank) means hiring for yourself; { name: 'undisclosed' } for an unnamed external client; or { name: '<company>' } plus optional description/location/sector/company_size. Stored in creation_parameters.hiring_for_company."New value: +"Who the position is really for. An object with name null/blank means hiring for yourself; { name: 'undisclosed' } for an unnamed external client; or { name: '<company>' } plus optional description/location/sector/company_size. Stored in creation_parameters.hiring_for_company."

Previous value: -[
-  "number",
-  "null"
-]New value: +"number"

Previous value: -"ISO date/time after which the interview is no longer available to candidates. null keeps it always available."New value: +"ISO date/time after which the interview is no longer available to candidates. An empty string keeps it always available."

Previous value: -"Conversation pace of the AI avatar. Omit/null keeps the template default pace. Options — `slower`: The avatar speaks more slowly — easier to follow for non-native speakers. | `normal`: Default speaking pace. | `faster`: The avatar speaks more quickly for a snappier conversation. | `fluent`: Talking pace: the avatar answers 300 ms after the candidate stops speaking. A pause mid-sentence also ends their turn.."New value: +"Conversation pace of the AI avatar. Omit to keep the current pace; `normal` is the default speaking pace. Options — `slower`: The avatar speaks more slowly — easier to follow for non-native speakers. | `normal`: Default speaking pace. | `faster`: The avatar speaks more quickly for a snappier conversation. | `fluent`: Talking pace: the avatar answers 300 ms after the candidate stops speaking. A pause mid-sentence also ends their turn.."

Previous value: -[
-  "string",
-  "null"
-]New value: +"string"

Previous value: -"Knowledge base store id the interview draws context from; validated for existence. null unlinks it."New value: +"Knowledge base store id the interview draws context from; validated for existence. An empty string unlinks it."

Previous value: -"Maximum number of AI follow-up questions. 0 disables follow-ups; presets are 0-3 (none/low/normal/high) and custom values start at 4; null uses the template default (Normal)."New value: +"Maximum number of AI follow-up questions. 0 disables follow-ups; presets are 0-3 (none/low/normal/high) and custom values start at 4; 2 is the template default (Normal)."

Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"

Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"

Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"

Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"

Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"

Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"

Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"

Previous value: -[
-  "ar",
-  "bg",
-  "zh",
-  "hr",
-  "cs",
-  "da",
-  "nl",
-  "en",
-  "fil",
-  "fi",
-  "fr",
-  "de",
-  "el",
-  "hi",
-  "hu",
-  "id",
-  "it",
-  "ja",
-  "ko",
-  "ms",
-  "no",
-  "pl",
-  "pt",
-  "br",
-  "ro",
-  "ru",
-  "sk",
-  "es",
-  "sv",
-  "ta",
-  "th",
-  "tr",
-  "uk",
-  "vi",
-  null
-]New value: +[
+  "ar",
+  "bg",
+  "zh",
+  "hr",
+  "cs",
+  "da",
+  "nl",
+  "en",
+  "fil",
+  "fi",
+  "fr",
+  "de",
+  "el",
+  "hi",
+  "hu",
+  "id",
+  "it",
+  "ja",
+  "ko",
+  "ms",
+  "no",
+  "pl",
+  "pt",
+  "br",
+  "ro",
+  "ru",
+  "sk",
+  "es",
+  "sv",
+  "ta",
+  "th",
+  "tr",
+  "uk",
+  "vi"
+]

Previous value: -[
-  "string",
-  "null"
-]New value: +"string"

Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"

Previous value: -[
-  "classic",
-  "modern",
-  "one_pager",
-  null
-]New value: +[
+  "classic",
+  "modern",
+  "one_pager"
+]

Previous value: -[
-  "string",
-  "null"
-]New value: +"string"

Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"

Previous value: -[
-  "string",
-  "null"
-]New value: +"string"

Previous value: -[
-  "array",
-  "null"
-]New value: +"array"

Previous value: -[
-  "array",
-  "null"
-]New value: +"array"

Previous value: -[
-  "array",
-  "null"
-]New value: +"array"

Previous value: -[
-  "string",
-  "null"
-]New value: +"string"

Previous value: -[
-  "string",
-  "null"
-]New value: +"string"

Previous value: -[
-  "array",
-  "null"
-]New value: +"array"

Previous value: -"Cheating/proctoring detection mode for candidate answers — this is NOT a full session recording. Video options also record the candidate. Omit/null to disable. Options — `audio_first_5_answers`: Audio-only cheating detection, first 5 answers only. | `audio_all`: Audio-only cheating detection on every answer. | `video_all`: Audio + video cheating detection on every answer (candidate is recorded for all answers). | `video_first_5_answers`: Audio + video cheating detection, first 5 answers only.."New value: +"Cheating/proctoring detection mode for candidate answers — this is NOT a full session recording. Video options also record the candidate. Omit to keep the current setting. A null is ignored: turn it off in the admin console. Options — `audio_first_5_answers`: Audio-only cheating detection, first 5 answers only. | `audio_all`: Audio-only cheating detection on every answer. | `video_all`: Audio + video cheating detection on every answer (candidate is recorded for all answers). | `video_first_5_answers`: Audio + video cheating detection, first 5 answers only.."

Previous value: -"Full interview-session recording (includes the avatar and voice) produced as a single file. Independent of `recording`. Omit/null to disable. Options — `audio_all`: Record the whole session audio (avatar + candidate voice) into a single file. Adds +0.2 credits. | `video_all`: Record the whole session video + audio (avatar + candidate) into a single file. Adds +0.4 credits.."New value: +"Full interview-session recording (includes the avatar and voice) produced as a single file. Independent of `recording`. Omit to keep the current setting. A null is ignored: turn it off in the admin console. Options — `audio_all`: Record the whole session audio (avatar + candidate voice) into a single file. Adds +0.2 credits. | `video_all`: Record the whole session video + audio (avatar + candidate) into a single file. Adds +0.4 credits.."

Previous value: -"Profile id of the recruiter owning this interview. Must be a merchant/merchant_owner/admin profile of the same merchant. null clears it."New value: +"Profile id of the recruiter owning this interview. Must be a merchant/merchant_owner/admin profile of the same merchant. An empty string clears it."

Previous value: -[
-  "boolean",
-  "null"
-]New value: +"boolean"

Previous value: -[
-  "none",
-  "minimal",
-  "minimal_with_score",
-  "advanced",
-  "full",
-  "full_expand_scores",
-  null
-]New value: +[
+  "none",
+  "minimal",
+  "minimal_with_score",
+  "advanced",
+  "full",
+  "full_expand_scores"
+]

Previous value: -[
-  "string",
-  "null"
-]New value: +"string"

Previous value: -[
-  "draft",
-  "active",
-  "archived",
-  "deleted",
-  "preparing",
-  "completed",
-  null
-]New value: +[
+  "draft",
+  "active",
+  "archived",
+  "deleted",
+  "preparing",
+  "completed"
+]

Previous value: -[
-  "string",
-  "null"
-]New value: +"string"

Previous value: -[
-  "interview",
-  "coaching",
-  "assessment",
-  null
-]New value: +[
+  "interview",
+  "coaching",
+  "assessment"
+]

Previous value: -[
-  "string",
-  "null"
-]New value: +"string"

Previous value: -[
-  "merchant_public",
-  "merchant_invite",
-  "merchant_unlisted",
-  null
-]New value: +[
+  "merchant_public",
+  "merchant_invite",
+  "merchant_unlisted"
+]

Previous value: -[
-  "string",
-  "null"
-]New value: +"string"

Added value: +{
+  "description": "With conditional_question_main_id: the answer to the yes/no question that shows this follow-up. `true` (the default) asks it after a yes, `false` after a no, so each answer can lead to its own follow-ups. Ignored on a question without conditional_question_main_id.",
+  "example": false,
+  "type": [
+    "boolean",
+    "null"
+  ]
+}

Previous value: -"For a conditional question, the id (the \"id\" field above) of the parent question in this same array that triggers it. The parent must appear earlier in the array than the conditional question referencing it."New value: +"For a follow-up question, the id (the \"id\" field above) of the yes/no question (is_conditional) in this same array that decides whether it is asked. The yes/no question must appear earlier in the array. Use conditional_question_answer to choose the answer that shows it."

Previous value: -"Conditional follow-up question (view 'with listening conditional'). Use with conditional_question_main_id."New value: +"A yes/no question that decides which follow-ups are asked (view 'with listening conditional'). Its follow-ups point at it with conditional_question_main_id."

Added value: +{
+  "description": "The candidate may skip this question: the recorded (offline avatar) interview shows a Skip button on it, and a skipped question is saved without an answer. Defaults to false.",
+  "example": false,
+  "type": [
+    "boolean",
+    "null"
+  ]
+}

Previous value: -"Conversation pace of the AI avatar. Omit/null keeps the template default pace. Options — `slower`: The avatar speaks more slowly — easier to follow for non-native speakers. | `normal`: Default speaking pace. | `faster`: The avatar speaks more quickly for a snappier conversation.."New value: +"Conversation pace of the AI avatar. Omit/null keeps the template default pace. Options — `slower`: The avatar speaks more slowly — easier to follow for non-native speakers. | `normal`: Default speaking pace. | `faster`: The avatar speaks more quickly for a snappier conversation. | `fluent`: Talking pace: the avatar answers 300 ms after the candidate stops speaking. A pause mid-sentence also ends their turn.."

Previous value: -[
-  "slower",
-  "normal",
-  "faster",
-  null
-]New value: +[
+  "slower",
+  "normal",
+  "faster",
+  "fluent",
+  null
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Company-defined position fields to set, {key: value}; a null value clears that field and keys you omit keep their value. Values are checked against the field definitions (option values, YYYY-MM-DD dates, {min, max, currency} ranges, user profile ids). Requires custom fields to be enabled for the company (else 403). Multi-stage positions only: on a single-stage interview the request is refused with 422.",
+  "example": {
+    "contract_type": "permanent",
+    "cost_centre": "CC-100"
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

Previous value: -"Interview style — configures the AI avatar and the follow-up questions it generates during the interview. Stored in creation_parameters; existing questions are NOT regenerated. Options — `pre-screening`: Pre-screening — quick qualification check focusing on basic requirements and availability. | `pre-screening-with-test-questions`: Pre-screening with test questions — pre-screening plus practical questions to test relevant skills. | `second-interview`: Second round interview — deeper dive for candidates who passed initial screening. | `remote-freelancer-verification`: Remote worker verification — verify remote work capabilities and communication skills. | `strength-based-interview`: Strength-based interview — focus on what candidates enjoy and excel at to predict job satisfaction. | `potential-based-interview`: Potential-based interview — assess learning ability and growth potential rather than past experience. | `process-verification-from-knowledge-base`: Knowledge Base interview — generate questions from your knowledge base documents.."New value: +"Interview style — configures the AI avatar and the follow-up questions it generates during the interview. Stored in creation_parameters; existing questions are NOT regenerated. Options — `pre-screening`: Pre-screening — quick qualification check focusing on basic requirements and availability. | `pre-screening-with-test-questions`: Pre-screening with test questions — pre-screening plus practical questions to test relevant skills. | `second-interview`: Second round interview — deeper dive for candidates who passed initial screening. | `remote-freelancer-verification`: Remote worker verification — verify remote work capabilities and communication skills. | `strength-based-interview`: Strength-based interview — focus on what candidates enjoy and excel at to predict job satisfaction. | `potential-based-interview`: Potential-based interview — assess learning ability and growth potential rather than past experience. | `process-verification-from-knowledge-base`: Knowledge Base interview — generate questions from your knowledge base documents. | `knockout-screening`: Knock-out screening — a short (about 5 minute) check of the role's must-haves with closed questions; ends early, politely, when a must-have is clearly not met. On creation it defaults custom_scoring.early_stop to true (where the avatar supports early stop) and max_followups to 1 unless you send them.."

Previous value: -[
-  "pre-screening",
-  "pre-screening-with-test-questions",
-  "second-interview",
-  "remote-freelancer-verification",
-  "strength-based-interview",
-  "potential-based-interview",
-  "process-verification-from-knowledge-base",
-  null
-]New value: +[
+  "pre-screening",
+  "pre-screening-with-test-questions",
+  "second-interview",
+  "remote-freelancer-verification",
+  "strength-based-interview",
+  "potential-based-interview",
+  "process-verification-from-knowledge-base",
+  "knockout-screening",
+  null
+]

Added value: +{
+  "description": "Which countries the interview / position is open to on the candidate portal, judged by the IP address the candidate opens it from (an unknown location only passes when countries_allowed / countries_allowed_eu are empty). From a closed country it is left out of the portal listings, and a direct link shows \"not available in your region\". Invited candidates (register_users / invite links) and candidates who already started keep access; API and MCP calls themselves are never restricted. Null = not used, every country.",
+  "properties": {
+    "countries_allowed": {
+      "description": "Available ONLY to candidates in these countries (ISO 3166-1 alpha-2).",
+      "example": [
+        "PH",
+        "IN"
+      ],
+      "items": {
+        "pattern": "^[A-Za-z]{2}$",
+        "type": "string"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "countries_allowed_eu": {
+      "description": "Adds every EU country (plus EEA and Switzerland) to countries_allowed.",
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "countries_blocked": {
+      "description": "NOT available to candidates in these countries (ISO 3166-1 alpha-2). Wins over the allowed side.",
+      "example": [
+        "US"
+      ],
+      "items": {
+        "pattern": "^[A-Za-z]{2}$",
+        "type": "string"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "countries_blocked_eu": {
+      "description": "Adds every EU country (plus EEA and Switzerland) to countries_blocked.",
+      "type": [
+        "boolean",
+        "null"
+      ]
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}

Previous value: -"Echo the conversation_id from the server's previous response. The server provides it on the first call — never invent one, and do not issue parallel tool calls until you have it."New value: +"Pass the exact conversation_id from the server's previous response, unchanged. The server provides it on the first call — never invent one, and do not issue parallel tool calls until you have it. Keep passing the same conversation_id for the rest of the conversation, including after later user messages or on a different task; do not reset it when the user starts a new request."

Added value: +{
+  "description": "SMS / WhatsApp notifications to the candidate, sent alongside the e-mails: \"reminders\" = with both e-mail reminders (day 1 and day 3); \"last_reminder\" = only with the final day-3 reminder; \"all\" = invitation, both reminders and the pre-screening-accepted step. null switches them off. WhatsApp is tried first, SMS when the number is not on WhatsApp. Available on paid plans (Starter and above) and needs a phone number on the candidate.",
+  "enum": [
+    "reminders",
+    "last_reminder",
+    "all",
+    null
+  ],
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Echo the conversation_id from the server's previous response. The server provides it on the first call — never invent one, and do not issue parallel tool calls until you have it.",
+  "type": "string"
+}

Added value: +{
+  "description": "Server-issued metadata for this conversation.",
+  "properties": {
+    "conversation_id": {
+      "description": "The server-issued conversation identifier.",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Previous value: -"Tone — configures the AI avatar's speaking style and the follow-up questions it generates. Stored in creation_parameters; existing questions are NOT regenerated. Suggested values — `relaxed`: Friendly and conversational tone that helps candidates feel at ease. | `simple`: Plain language at CEFR A2 level — short sentences and simple words. | `professional`: Formal and business-like approach suitable for senior roles. | `persuasive`: Engaging style that encourages candidates to elaborate.. Case-insensitive; other strings are accepted but unknown tones fall back to the default."New value: +"Tone — configures the AI avatar's speaking style and the follow-up questions it generates. Stored in creation_parameters; existing questions are NOT regenerated. Case-insensitive; omit to default to relaxed. Options — `relaxed`: Friendly and conversational tone that helps candidates feel at ease. | `simple`: Plain language at CEFR A2 level — short sentences and simple words. | `professional`: Formal and business-like approach suitable for senior roles. | `persuasive`: Engaging style that encourages candidates to elaborate. | `exact`: Asks the questions exactly as provided, without rephrasing — for interviews built from your own questions (create_interview_from_questions) where the wording is a script.."

Added value: +[
+  "relaxed",
+  "simple",
+  "professional",
+  "persuasive",
+  "exact",
+  null
+]

Previous value: -"Report language code (platform-languages.json code)."New value: +"Report language code (a platform-languages.json code)."

Added value: +[
+  "ar",
+  "bg",
+  "zh",
+  "hr",
+  "cs",
+  "da",
+  "nl",
+  "en",
+  "fil",
+  "fi",
+  "fr",
+  "de",
+  "el",
+  "hi",
+  "hu",
+  "id",
+  "it",
+  "ja",
+  "ko",
+  "ms",
+  "no",
+  "pl",
+  "pt",
+  "br",
+  "ro",
+  "ru",
+  "sk",
+  "es",
+  "sv",
+  "ta",
+  "th",
+  "tr",
+  "uk",
+  "vi",
+  null
+]

Added value: +{
+  "description": "Which of your webhook environments results from this interview are delivered to. Defaults to production. Options — `production`: Live hiring. Results reach the webhooks configured as production. This is the default when the field is omitted. | `uat`: User-acceptance testing - an isolated environment for pre-release verification. | `development`: Development/testing. Use for interviews created by a test or preview app so their results never reach the production webhook. | `demo`: Demonstrations and sales trials..",
+  "enum": [
+    "production",
+    "uat",
+    "development",
+    "demo",
+    null
+  ],
+  "example": "production",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -"Report layout: classic (default), modern, or one_pager."New value: +"Report layout: classic, modern, or one_pager. Omit for the merchant default (modern when unset)."

Added value: +{
+  "description": "Report layout: classic (default), modern, or one_pager.",
+  "enum": [
+    "classic",
+    "modern",
+    "one_pager",
+    null
+  ],
+  "type": [
+    "string",
+    "null"
+  ]
+}

Previous value: -"Long-form interview description (column `interview_description_long`), Markdown."New value: +"Long-form interview description (column `interview_description_long`). Rendered as Markdown on the candidate-facing position page, including chips, callouts, cards, columns and buttons — formatting guide: https://developer.jobmojito.com/cookbooks/format-content-with-markdown"

Previous value: -"What the question diff decided, question by question. Null when `questions` was not sent."New value: +"What the question diff decided, question by question. Absent when `questions` was not sent."

Previous value: -[
-  "position_id",
-  "is_multistage",
-  "updated_fields",
-  "questions_diff"
-]New value: +[
+  "position_id",
+  "is_multistage",
+  "updated_fields"
+]

Added value: +{
+  "description": "OPTIONAL. Omit this field entirely and the interview's questions are left exactly as they are — this endpoint only touches questions when you send the array. When you do send it, send the COMPLETE list you want the interview to end up with, in order, in the same format job-interview-create-from-array accepts and job-interview-get returns: there is no way to change a single question on its own, so read the interview, edit that array, and send the whole thing back. An empty array is rejected. It is applied as a DIFF, not a replace, so resending the array job-interview-get gave you changes nothing at all. Each entry is matched against what is stored — first on `external_id`, then on `id`, then on identical content — and: an entry matching an unchanged question keeps that question exactly as it is, including its answer rules and any rendered avatar video; an entry matching a question whose content differs unlinks the old question and creates a new one in its place (fields you omit are carried over from the old one); an entry matching nothing is created; and a stored question no entry matches is unlinked. `questions_diff` in the response reports exactly what was decided. Questions are shared records, so nothing is ever deleted — removing one only unlinks it from this interview, and an edit is always unlink-old + create-new so the change cannot leak into another interview reusing the same question. The welcome, thank-you and instructional-video steps are not part of this array and are left in place. Single-stage interviews only; for a multi-stage position, update its interview stages individually.",
+  "items": {
+    "additionalProperties": {},
+    "properties": {
+      "candidate_expectations_json": {
+        "description": "Per-question candidate expectations, bucketed by requirement level (weak/moderate/strong). Extra keys are preserved.",
+        "properties": {
+          "moderate": {
+            "description": "Requirements expected of a solid, competent candidate.",
+            "items": {
+              "type": "string"
+            },
+            "type": [
+              "array",
+              "null"
+            ]
+          },
+          "strong": {
+            "description": "High-bar requirements only standout candidates clear.",
+            "items": {
+              "type": "string"
+            },
+            "type": [
+              "array",
+              "null"
+            ]
+          },
+          "weak": {
+            "description": "Baseline requirements every viable candidate should meet (table stakes).",
+            "items": {
+              "type": "string"
+            },
+            "type": [
+              "array",
+              "null"
+            ]
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "conditional_question_main_id": {
+        "description": "For a conditional question, the id (the \"id\" field above) of the parent question in this same array that triggers it. The parent must appear earlier in the array than the conditional question referencing it.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "duration": {
+        "description": "Answer duration in seconds for this question.",
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "external_data": {
+        "additionalProperties": {},
+        "description": "Arbitrary JSON metadata stored on the question.",
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "external_id": {
+        "description": "External identifier stored on the question. job-interview-update matches on this first, so an ATS that owns stable ids can send its own array and have the diff line up without round-tripping our ids.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "id": {
+        "description": "Identifier for this question. job-interview-get returns the question's real id here; send it back to job-interview-update so an unchanged question keeps its existing record (and with it its answer rules and any rendered avatar video). Also the handle another question references via conditional_question_main_id. On job-interview-create-from-array it is a caller-local value, only needed for those references.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "is_candidate_asking_recruiter": {
+        "description": "Candidate-asks-recruiter prompt (view 'candidate asking recruiter').",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "is_conditional": {
+        "description": "Conditional follow-up question (view 'with listening conditional'). Use with conditional_question_main_id.",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "is_expert": {
+        "description": "Expert listening question (view 'with listening expert').",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "is_multiple_choice": {
+        "description": "Multiple-choice question (view 'multiple choice').",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "is_without_scoring": {
+        "description": "Question is asked but not scored (view 'without scoring').",
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "knowledge_base_id": {
+        "description": "Knowledge-base store id (uuid) the question draws context from.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "label": {
+        "description": "Optional label/tag stored on the question.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "mojito_language_code": {
+        "description": "Per-question language override (one of the platform-languages.json codes). Inherits the interview language when omitted.",
+        "enum": [
+          "ar",
+          "bg",
+          "zh",
+          "hr",
+          "cs",
+          "da",
+          "nl",
+          "en",
+          "fil",
+          "fi",
+          "fr",
+          "de",
+          "el",
+          "hi",
+          "hu",
+          "id",
+          "it",
+          "ja",
+          "ko",
+          "ms",
+          "no",
+          "pl",
+          "pt",
+          "br",
+          "ro",
+          "ru",
+          "sk",
+          "es",
+          "sv",
+          "ta",
+          "th",
+          "tr",
+          "uk",
+          "vi",
+          null
+        ],
+        "example": "en",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "question": {
+        "description": "The question text shown to the candidate.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "question_alternatives": {
+        "description": "Alternative phrasings for the question.",
+        "items": {
+          "type": "string"
+        },
+        "type": [
+          "array",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "question"
+    ],
+    "type": "object"
+  },
+  "minItems": 1,
+  "type": [
+    "array",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Re-derive the interview-level `candidate_expectations_json` scoring rubric from the resulting question list, the way job-interview-create-from-array derives it at creation time. Only applies when `questions` is sent, the interview type is `interview`, and `candidate_expectations_json` is not also being set explicitly (an explicit value wins).",
+  "example": false,
+  "type": [
+    "boolean",
+    "null"
+  ]
+}

Added value: +{
+  "description": "What the question diff decided, question by question. Null when `questions` was not sent.",
+  "properties": {
+    "added": {
+      "description": "Ids of the questions created for entries that matched nothing stored.",
+      "items": {
+        "type": "string"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "kept": {
+      "description": "Questions left exactly as they were, record and all.",
+      "items": {
+        "type": "string"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "question_ids": {
+      "description": "The interview's full ordered step list after the update, including the welcome / thank-you / instructional steps this endpoint does not manage.",
+      "items": {
+        "type": "string"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "reactivated": {
+      "description": "True when the interview was already active and was re-published so the new questions go live.",
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "removed": {
+      "description": "Ids unlinked because no entry in the request matched them. The question records themselves still exist.",
+      "items": {
+        "type": "string"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "replaced": {
+      "description": "Edited questions: the old record was unlinked and a new one created, so the change cannot leak into other interviews reusing it.",
+      "items": {
+        "properties": {
+          "from": {
+            "description": "The id that was unlinked.",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "to": {
+            "description": "The id of the question created in its place.",
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "from",
+          "to"
+        ],
+        "type": "object"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "kept",
+    "added",
+    "removed",
+    "replaced",
+    "question_ids",
+    "reactivated"
+  ],
+  "type": "object"
+}

Previous value: -"Names of the stored columns that were written, plus `status` when the lifecycle status was changed."New value: +"Names of the stored columns that were written, plus `status` when the lifecycle status was changed and `questions` when the question list was diffed."

Previous value: -[
-  "position_id",
-  "is_multistage",
-  "updated_fields"
-]New value: +[
+  "position_id",
+  "is_multistage",
+  "updated_fields",
+  "questions_diff"
+]