v4

OpenAPI 3.1.02026-08-0255174167.5 KB
account

Update the current account

patch/api/v1/account

Headers

Authorizationstring required

Your Dial API key, sent as Authorization: Bearer sk_live_...

Request body

maxCallDurationSecondsinteger nullable

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.

idstring
emailstring email

The account owner's address. This identifies the account and is the same for every member — it is not the caller's own address.

role'owner' | 'member'

The calling API key's role in this account. member keys can do everything except delete the account.

callerEmailstring email

The caller's own address, as opposed to email above (the owner's). The two are identical for an owner key.

createdAtstring date-time
maxCallDurationSecondsinteger nullable

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.