Create a new persona
Creates a new persona for the authenticated project.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Input for creating a new persona
The name the agent will identify as during conversations
Primary language ISO 639-1 code for the persona
EN, ES, DE, HI, FR, NL, AR, EL, IT, ID, TH, JA, TL, MS, ZH, TR, PT, HE Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with optional variants
US, US_X_SOUTH, GB, ES, DE, IN, FR, NL, SA, GR, AU, IT, ID, TH, JP, NZ, PH, SG, MY, HK, TR, PT, IL Gender of the persona
MALE, FEMALE Label shown in place of the name across the dashboard (e.g. a short descriptor like "Irate Escalator"). The persona still identifies as name on calls. Omit or set null to display the name itself.
Human-readable description of the persona
Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish)
EN Languages the persona can understand. Defaults to the languages the persona speaks.
1EN, ES, DE, HI, FR, NL, AR, EL, IT, ID, TH, JA, TL, MS, ZH, TR, PT, HE How old the caller sounds and behaves. Only ages the persona's accent has a voice for are accepted; defaults to ADULT, which every accent supports.
CHILD, TEENAGER, ADULT, ELDERLY Background noise setting
NONE, AIRPORT, CHILDREN_PLAYING, CITY, COFFEE_SHOP, CONSTRUCTION, CRYING_BABY, DRIVING, LIBRARY, OFFICE, THUNDERSTORM, TRAIN Speech pace of the persona
SUPER_SLOW, SLOW, NORMAL, FAST, SUPER_FAST Speech clarity of the persona
CLEAR, VAGUE, RAMBLING Whether the persona uses filler words like "um" and "uh"
Base emotional state of the persona
NEUTRAL, CHEERFUL, CONFUSED, FRUSTRATED, SKEPTICAL, RUSHED, DISTRACTED, ANGRY, ANXIOUS, SAD How clearly the persona expresses their intentions
CLEAR, INDIRECT, VAGUE How the persona confirms information
EXPLICIT, VAGUE How reliable the persona's memory is
HIGH, LOW Deprecated and inert: it no longer affects the call. It set how long the persona waited once the agent stopped talking, and measured across production simulations it moved the reply gap by less than the noise floor, because model and speech latency dominate it. Every persona now uses one voice-activity profile. Use interruption for a caller who talks over the agent. Still accepted and stored so existing clients keep working. BARGE_IN is stored as responseTiming: QUICK with interruption: OCCASIONAL.
RELAXED, NORMAL, QUICK, BARGE_IN How much the persona talks over the agent. Defaults to OFF, a caller that waits its turn.
OFF, BACKCHANNEL, OCCASIONAL, HEAVY Background story and behavioral patterns for the persona
"A busy professional calling during lunch break"
Messages the persona will say when the agent goes silent during a call. Defaults to language-appropriate phrases when omitted or sent as null.
Seconds of silence before the persona sends an idle message
5 <= x <= 60Maximum number of idle messages the persona will send before giving up
1 <= x <= 10Whether the idle message counter resets when the agent speaks
Additional custom properties about the persona
Response
The created persona