REST APISelf Hosted

Get Self-Hosted configuration

View as Markdown

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.

Authentication

AuthorizationBearer

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

Response

The Self-Hosted configuration.

enabledboolean

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

accessenum

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.

activeModeenum

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).

accessRequestobject or nullOptional

Your most recent access request, or null if you have never submitted one (including accounts that already have access without asking).

llmobject or nullOptional

The LLM-mode config, or null until that mode is configured.

audioobject or nullOptional

The audio-mode config, or null until that mode is configured.

Errors

401
Unauthorized Error