FAQ

Common customer questions about tunnel setup, SDK usage, allowlists, providers, and billing.

Fallbakit dashboard overview used as a reference for common setup and operational questions. — Most FAQ answers map back to the overview: whether the dashboard is connected, whether runners are healthy, and whether traffic is routing locally or to fallback.

Which base URL should my app use?

Use https://api.fallbakit.com with Fallbakit SDKs. If you use the official OpenAI SDK, set its base URL to https://api.fallbakit.com/v1.

Do SDKs read API keys from environment variables automatically?

No. Constructors require an explicit API key. Keep the key in your environment variables or secret manager, then pass it into the SDK.

Why am I getting `application_not_allowed`?

The request did not match the selected application's allowlist. Add the browser domain from Origin or the server egress IP/CIDR from which your app sends chat requests.

Can I call Fallbakit without a tunnel?

Cloud-only requests can be made when provider credentials are configured, but local-first routing needs a connected tunnel agent that can reach the local runtime.

Are provider keys shared across applications?

No. Provider credentials are application-scoped so each app can use separate fallback credentials and policies.

What happens when the local runtime is offline?

If fallback is enabled and a provider is configured, Fallbakit can route to the requested fallback provider/model. If fallback is disabled, the request fails instead of using cloud.