Skip to navigation

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.

Allowed values:
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).

Allowed values:
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