v4
OpenAPI 3.1.02026-08-0255174167.5 KBUpdate the current account
Headers
Your Dial API key, sent as Authorization: Bearer sk_live_...
Request body
Account-wide default cap on call length, in seconds, for every inbound and outbound call on the account. The effective cap on a call is the first one set in priority order — the per-call cap, then the number's cap, then this account cap — falling back to the global default when none is set. A higher-priority level overrides a lower one (it can raise or lower the limit), so this account cap applies only when neither the call nor the number sets one. Must be between 60 and 3600 seconds (1 minute to 1 hour); a value outside that range returns 400. Send null to clear it (falls back to the global default). Free accounts — accounts that have never added credit and never subscribed — are capped at 300 seconds (5 minutes), reported as limits.maxCallDurationSeconds on the account: a higher value sent here returns 400, and a cap inherited from another level is clamped to 300. When a cap is active, Dial warns ~30–40 seconds before the hard cut so the agent can wrap up naturally (managed and LLM self-hosted: an injected spoken prompt; audio self-hosted: a duration_warning protocol frame).
Response
Updated.
The account owner's address. This identifies the account and is the same for every member — it is not the caller's own address.
The calling API key's role in this account. member keys can do everything except delete the account.
The caller's own address, as opposed to email above (the owner's). The two are identical for an owner key.
Call-length cap in seconds; the effective cap on a call is the first one set in priority order — per-call, then number, then account — falling back to the global default. A higher-priority level overrides a lower one. Null means this level sets no cap. Free accounts (never added credit, never subscribed) are additionally capped by limits.maxCallDurationSeconds regardless of any configured cap.