Skip to main content

Platform Settings

The platform settings page shows your DialStack platform configuration, including status and API keys.

Viewing Platform Information​

Navigate to your platform from the sidebar (the platform name appears in the navigation for platform admins). The platform detail page shows:

  • Handle — Your platform's unique identifier
  • Status — Whether the platform is Active, Suspended, or Cancelled
  • Publishable Key — The public API key used in client-side SDK integrations
  • Created — When the platform was created

Managed AI Agent​

The Managed AI Agent toggle controls whether the built-in AI agent is offered to your accounts when they create a voice app. Turn it off if your platform provides its own AI experience and you don't want the built-in agent shown to your customers.

When the toggle is off:

  • The managed AI agent option no longer appears when creating a voice app, and its documentation is hidden from your branded help. Custom (webhook) voice apps are unaffected.
  • Any managed agents that already exist keep working and stay editable — turning the setting off never strands existing configuration.

This is the platform-wide default. You can override it for an individual account from that account's settings (see Managing Accounts).

API Keys​

Your platform has two types of API keys, each with a live and a test variant (see test mode vs live mode for what each variant does):

  • Publishable Key — Safe to include in client-side code. Used to initialize the DialStack SDK.
  • Secret Key — Must be kept confidential. Used for server-to-server API calls. This key is only shown once, at platform creation or when you rotate keys.

Click the copy icon next to any key to copy it to your clipboard.

Webhook Secret​

The Webhook Secret is separate from the Secret Key. It is used to sign webhook deliveries so your receiving endpoint can verify that a webhook actually came from DialStack and hasn't been tampered with. It is not an API key and cannot be used to call the API.

In short:

  • Secret Key — authenticates your calls to our API.
  • Webhook Secret — lets you authenticate our calls to your webhook endpoint.

Account-scoped webhook endpoints​

A webhook endpoint is normally platform-wide: it receives events for every account in its mode (live or sandbox). You can instead register endpoints scoped to a single account, so a dedicated receiver gets only that account's events.

Account scoping is additive: an account-scoped endpoint receives its account's events in addition to your platform-wide endpoints — it does not remove those events from the platform-wide delivery. This is useful when one account (for example a staging or demo account) needs its events delivered to a separate URL, without that receiver ever seeing any other account's events.

Manage an account's webhook endpoints from that account's page (Webhook Endpoints, on the General tab). This section is available to platform administrators only. Over the API, include the DialStack-Account header on the webhook-endpoint calls to manage a specific account's endpoints; omit it to manage your platform-wide endpoints.