PersonaCreateRequest

role_namestringrequired

The job role being interviewed for. Injected into the generated system prompt.

Possible values: <= 200 characters

Example: Senior Backend Engineer

languagestringrequired

The interview language (engines are multilingual). One language per persona.

Possible values: <= 64 characters

Example: en

system_promptstringnullable

Optional. Supply your own interviewer system prompt to store verbatim. Omit it (or send empty) to have ZenHire generate one server-side from the v1 template for the given role_name + language.

Possible values: <= 20000 characters

base_prompt_overridestringnullable

Optional override of the global behavioral base prompt (turn-taking / pacing layer). Omit or send null to inherit ZenHire's default.

Possible values: <= 20000 characters

PersonaCreateRequest

{
  "role_name": "Senior Backend Engineer",
  "language": "en",
  "system_prompt": "string",
  "base_prompt_override": "string"
}