Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-136188852.7 MB

9cd7291d4228

personas

Update a persona's voice call behavior settings

Partially update a persona's voice call behavior settings.

Unset fields are left unchanged; the merged result is fully validated. The write is row-locked and actor-audited; persona settings drive the persona side of voice simulations (overlaid onto the simulation pipeline configuration at run setup).

patch/v1/personas/{persona_id}/call-settings

Path parameters

persona_idstring uuid required

Request body

interruptions_enabledboolean nullable
interruption_min_wordsinteger nullable
interruption_min_duration_msinteger nullable
interruption_backoff_msinteger nullable
interruption_trigger_phrasesstring[] nullable
interruption_hard_phrasesstring[] nullable
interruption_final_transcript_grace_msinteger nullable
dtmf_enabledboolean nullable
dtmf_termination_digitstring nullable
dtmf_inter_digit_timeout_msinteger nullable
dtmf_max_digitsinteger nullable
dtmf_prefixstring nullable
max_call_duration_msinteger nullable
silence_timeout_msinteger nullable
silence_reminder_countinteger nullable
silence_reminder_mode'static' | 'auto' nullable
silence_reminder_messagestring nullable
silence_end_action'hangup_immediate' | 'speak_then_hangup' nullable
silence_end_messagestring nullable
voicemail_detection_mode'off' | 'leave_message' nullable
voicemail_detection_timeout_msinteger nullable
voicemail_detection_modelstring nullable
voicemail_messagestring nullable
background_audio_enabledboolean nullable
background_audio_preset'office' | 'cafe' | 'city' | 'keyboard_typing' | 'keyboard_typing2' nullable
background_audio_volumenumber nullable
background_audio_loopboolean nullable
recording_enabledboolean nullable

Response

Successful Response

interruptions_enabledboolean
interruption_min_wordsinteger
interruption_min_duration_msinteger
interruption_backoff_msinteger
interruption_trigger_phrasesstring[]
interruption_hard_phrasesstring[]
interruption_final_transcript_grace_msinteger
dtmf_enabledboolean
dtmf_termination_digitstring
dtmf_inter_digit_timeout_msinteger
dtmf_max_digitsinteger
dtmf_prefixstring
max_call_duration_msinteger
silence_timeout_msinteger
silence_reminder_countinteger
silence_reminder_mode'static' | 'auto'
silence_reminder_messagestring nullable
silence_end_action'hangup_immediate' | 'speak_then_hangup'
silence_end_messagestring nullable
voicemail_detection_mode'off' | 'leave_message'
voicemail_detection_timeout_msinteger
voicemail_detection_modelstring nullable
voicemail_messagestring nullable
background_audio_enabledboolean
background_audio_preset'office' | 'cafe' | 'city' | 'keyboard_typing' | 'keyboard_typing2' nullable
background_audio_volumenumber
background_audio_loopboolean
recording_enabledboolean