Update organization interview defaults
Read or partially update your organization’s interview defaults.
These fields act as defaults for every job posting in the organization. When a job’s own interview configuration leaves a field blank (for example prompt_intro), the interview runtime uses the value from this endpoint. Clearing a field here reverts every job that has not set its own override to the platform default.
PATCH is a partial update. Omit a field to leave it unchanged, or send an empty string to clear it. This resource is a singleton per organization: PUT, POST, and DELETE are not supported.
Fields:
prompt_intro: opening script the voice assistant reads at the start of an interview.prompt_outro: closing script the voice assistant reads at the end of an interview.prompt_additional_instructions: free-form behavior guidance for the voice assistant, such as tone, off-limit topics, or style. Applied in addition to per-job instructions.interviewer_name_override: name the voice assistant introduces itself with. Blank falls back to the platform default.organization_name_override: name the voice assistant uses to refer to your organization during the call. Blank falls back to your organization’s display name.cv_context_mode: how much of the candidate’s CV the interview agent receives:summary,disabled, orfull.require_recording_consent: when true, the interviewer asks the candidate to agree to the call being recorded before the interview starts, and ends the call if they decline.
Authorizations
API key authentication for the public API. Pass your API key as a Bearer token.
Body
Default intro script for new interviews in this organization.
Default outro script for new interviews in this organization.
Default additional voice-assistant instructions for new interviews in this organization.
Org-wide interviewer name for interviews. Blank falls back to the system default name.
100Org-wide organization name spoken in interviews. Blank falls back to the organization's name.
100How much of the candidate's CV the interview agent receives. SUMMARY gives the latest role and top skills only. DISABLED omits the CV entirely. FULL gives the complete dated work and education history AND lets the agent raise up to two topics drawn from it, so it may ask about a career change or an unexplained employment gap. Choose FULL only if that questioning is wanted, not merely to give the agent more context.
disabled- Disabled (No CV context)summary- Summary (Key highlights only)full- Full (Complete CV markdown)
disabled, summary, full When enabled, the interviewer asks the candidate to agree to the call being recorded before the interview starts, and ends the call if they decline. When disabled, no consent question is asked.
Interview mode applied to new job postings that do not specify one. WEB runs the interview in the browser, PHONE calls the candidate.
web- Webphone- Phone
web, phone Extra instructions passed to criteria and question generation for every job in this organization, for example to ask for a short screening rather than a full interview. Blank means no extra steering.
Response
Default intro script for new interviews in this organization.
Default outro script for new interviews in this organization.
Default additional voice-assistant instructions for new interviews in this organization.
Org-wide interviewer name for interviews. Blank falls back to the system default name.
100Org-wide organization name spoken in interviews. Blank falls back to the organization's name.
100How much of the candidate's CV the interview agent receives. SUMMARY gives the latest role and top skills only. DISABLED omits the CV entirely. FULL gives the complete dated work and education history AND lets the agent raise up to two topics drawn from it, so it may ask about a career change or an unexplained employment gap. Choose FULL only if that questioning is wanted, not merely to give the agent more context.
disabled- Disabled (No CV context)summary- Summary (Key highlights only)full- Full (Complete CV markdown)
disabled, summary, full When enabled, the interviewer asks the candidate to agree to the call being recorded before the interview starts, and ends the call if they decline. When disabled, no consent question is asked.
Interview mode applied to new job postings that do not specify one. WEB runs the interview in the browser, PHONE calls the candidate.
web- Webphone- Phone
web, phone Extra instructions passed to criteria and question generation for every job in this organization, for example to ask for a short screening rather than a full interview. Blank means no extra steering.

