WHwhispa
training-personas

Create Training Persona

Create a training persona (admin only).

post/training-personas

Request

  • Base URL
    https://dev.whispa.net (the document declares no server; this is the origin it was published from)
  • Auth
    • OAuth 2
      Password
      Token URL: auth/bearer/login
    • or API key in cookie access_token

Request body

namestring required

Unique persona identifier

display_namestring required

Human-readable name

descriptionstring required

Situation summary shown on the persona card

scenario_idstring uuid required

Training scenario this persona belongs to

debtor_namestring required

Fictional debtor full name

date_of_birthstring nullable
addressstring nullable
creditor_accountstring nullable

Creditor / account description

amount_owedstring nullable

Free-text overdue amount

temperament_tagsstring[]

Temperament labels driving card badges (e.g. busy, aggressive)

difficultystring

easy | medium | hard

affordabilitystring nullable

What the debtor can realistically pay

backstorystring nullable

Extra colour for how the persona behaves

prompt_overridestring nullable

Verbatim simulation prompt; wins over the structured template

first_messagestring nullable

Opening line the simulated customer speaks

voicestring nullable

Simulated customer voice: male | female (null = agent default)

is_activeboolean

Whether the persona is shown

Response

Successful Response

idstring uuid required
namestring required
display_namestring required
descriptionstring required
scenario_idstring uuid required
scenario_namestring nullable

Joined Scenario.name for /training hydration

scenario_display_namestring nullable
debtor_namestring required
date_of_birthstring nullable required
addressstring nullable required
creditor_accountstring nullable required
amount_owedstring nullable required
temperament_tagsstring[] required
difficultystring required
affordabilitystring nullable required
backstorystring nullable required
prompt_overridestring nullable required
first_messagestring nullable required
voicestring nullable required
resolved_promptstring required

Final simulation prompt (override or structured template)

resolved_voice_idstring nullable

ElevenLabs voice ID for the persona's voice, applied as a runtime TTS override at call start (null = agent default voice)

is_activeboolean required
created_bystring uuid nullable required
updated_bystring uuid nullable required
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.