Create a persona
POST/api/v1/interview/personas
Creates a reusable interviewer persona for your client. You supply the
role_name and the interview language. By default the AI system
prompt is generated server-side from ZenHire's v1 interviewer template
for that role and language.
Prompt authoring is optional: supply your own system_prompt to
store verbatim instead of the generated one, and/or
base_prompt_override to replace the global behavioral base prompt
(turn-taking / pacing layer). Omit both to inherit ZenHire's defaults.
The persona is owned by your client and can be reused across any number of candidate sessions.
Request
Responses
- 201
- 400
- 401
- 403
- 500
Persona created.
Validation error — role_name or language missing or too long.
Authentication required.
The client does not have the interview permission enabled, or is not active.
Internal error.