duration_warning

Direction: Dial → your server. Sent once, ~30 seconds before the call hits its maximum-duration cap, so your agent can wrap up naturally before Dial ends the call. If no cap applies to the call, this frame never arrives.

This is the audio variant’s analog of the spoken warning Dial injects on managed and LLM self-hosted calls — but since Dial isn’t running the voice here, it notifies your stack instead, and your agent speaks the wind-down.

When the cap is reached Dial ends the call with call_ended and reason: "duration_limit".

Schema

Example

1
{ "type": "duration_warning", "seconds_remaining": 30 }