Skip to main content
Deepgram's Docs

Search documentation

Type to search this documentation.

On this pageOverview

June 15, 2026

UpdateListen: On-the-Fly Listen Configuration

Section titled “UpdateListen: On-the-Fly Listen Configuration”

You can now update the Listen configuration during a conversation without restarting the session. Send an UpdateListen message to tune:

  • eot_threshold — end-of-turn confidence threshold
  • eager_eot_threshold — eager end-of-turn confidence threshold
  • eot_timeout_ms — hard timeout for turn completion
  • keyterms — keyword boost list
  • language_hints — language bias for multilingual models

The payload nests tunable fields under listen.provider, matching the shape used in the Settings message. The provider identity (type, version, model) is required and must match the current session.

JSON
{
  "type": "UpdateListen",
  "listen": {
    "provider": {
      "type": "deepgram",
      "version": "v2",
      "model": "flux-general-multi",
      "eot_threshold": 0.8,
      "eager_eot_threshold": 0.5,
      "eot_timeout_ms": 3000,
      "keyterms": ["Deepgram", "speech-to-text"],
      "language_hints": ["en", "es"]
    }
  }
}

UpdateListen is a partial update — omitted tunable fields keep their current value, except language_hints which resets to empty when omitted. Always re-send language_hints if you want to preserve language biasing.

The server responds with a ListenUpdated acknowledgement once the changes are applied.

For details, see the UpdateListen documentation.

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu