latestOpenAPI 3.1.02026-08-1557182178.2 KB

85518ccab2aa

selfHosted

Get Self-Hosted configuration

Returns the account's Self-Hosted configuration. The signing secret is never returned here — only a masked preview (secretMasked). Use GET /api/v1/self-hosted/secret to copy the full value.

get/api/v1/self-hosted

Headers

Authorizationstring required

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

Response

The Self-Hosted configuration.

enabledboolean required

Whether Self-Hosted mode is currently driving the account's calls.

access'none' | 'pending' | 'granted' | 'denied' required

Whether this account may configure Self-Hosted mode. Self-Hosted lets a third-party server drive live calls, so accounts are approved before they can point calls at one.

none — no access and no request on file; submit one with the request_access action. pending — a request is awaiting review. granted — you may save and activate freely. denied — the request was reviewed and turned down; accessRequest.reviewNote says why.

Accounts that already had Self-Hosted before approval was introduced are granted — nothing changed for them.

activeMode'llm' | 'audio' required

Which mode drives calls when enabled: "llm" (Dial runs voice; your server drives the conversation in text) or "audio" (Dial pipes the raw call audio to your server, full duplex).