Skip to main content
Send an UpdateConfiguration message during an active streaming session to change session parameters without reconnecting. Every field is optional — include only the parameters you want to change.
{
  "type": "UpdateConfiguration",
  "keyterms_prompt": ["account number", "routing number"],
  "max_turn_silence": 5000
}

Supported fields

Mode

FieldTypeModels
mode"min_latency" | "balanced" | "max_accuracy"U3 Pro
Switch between accuracy/latency trade-off modes mid-session. See Optimizing accuracy and latency.

Turn detection

FieldTypeModels
min_turn_silenceint (ms)U3 Pro, Universal Streaming
max_turn_silenceint (ms)U3 Pro, Universal Streaming
interruption_delayint (ms)U3 Pro
  • min_turn_silence — Minimum silence in ms before an end-of-turn check fires. Lower values produce faster turn endings; higher values reduce entity splitting on numbers and proper nouns.
  • max_turn_silence — Maximum silence in ms before forcing a turn to end, regardless of confidence. Increase for moments where you expect a longer pause (caller reading out a number, address, etc.).
  • interruption_delay — How quickly the first partial is emitted on U3 Pro. Lower values produce faster TTFT for aggressive barge-in; higher values produce more confident first partials. See Tuning early partial timing.

VAD

FieldTypeModels
vad_thresholdfloat (0–1)U3 Pro, Universal Streaming
  • vad_threshold — Confidence threshold for classifying audio frames as speech. Increase for noisy environments to reduce false speech detection.

Prompting and context

FieldTypeModels
promptstringU3 Pro
keyterms_promptstring[]U3 Pro, Universal Streaming
agent_contextstringU3 Pro
  • prompt — Update behavioral or formatting instructions mid-stream. See Prompting guide.
  • keyterms_prompt — Replace the current keyterms list. The most effective way to improve recognition accuracy mid-stream — dynamically swap the list as your voice agent moves between conversation stages. See Keyterms prompting.
  • agent_context — Pass your voice agent’s most recent spoken reply so the model has it as context for the next user turn. See Context carryover.

Partials

FieldTypeModels
continuous_partialsboolU3 Pro
  • continuous_partials — Toggle steady-cadence partial emission on or off mid-session.

Example

Set the keyterms for a caller-identification stage of a voice agent flow:
websocket.send(json.dumps({
    "type": "UpdateConfiguration",
    "keyterms_prompt": ["Kelly Byrne-Donoghue", "date of birth", "January", "February"],
}))

Behavior notes

  • UpdateConfiguration is a delta. Fields you omit keep their current values.
  • mode, prompt, agent_context, interruption_delay, and continuous_partials are U3 Pro only.