REST APIAccount

Update the current account

View as Markdown

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.
maxCallDurationSecondsinteger or nullOptional60-3600
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.
idstringOptional
emailstringOptionalformat: "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.

roleenumOptional

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

callerEmailstringOptionalformat: "email"

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

createdAtdatetimeOptional
apiKeyslist of objectsOptional
maxCallDurationSecondsinteger or nullOptional

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.

limitsobject or nullOptional

Guardrails applied to a free account — one that has never added credit and never subscribed. Null once the account has paid: both limits lift permanently on the first top-up or subscription. Read this instead of hardcoding the values, which can change.

Errors

400
Bad Request Error
401
Unauthorized Error