Create & configure a gateway

This guide walks you through creating a gateway and wiring up everything it governs. For the conceptual model — BYOK passthrough, context injection, policies, audit — see Gateway.

1. Create the gateway

In the dashboard, go to Gateways and click Create Gateway.

1. Name it (e.g. Production API Gateway). The slug auto-generates from the name — a URL-safe identifier you can override.
2. Add an optional description.
3. Pick an environment: Production, Staging, or Development.

Click Create Gateway. You land on the gateway detail page, organized into tabs: General, Setup, Providers, Policies, Blueprints, API Keys, and Context.

2. Enable a provider

Open the Providers tab and click Add Provider.

1. Choose a Provider Type — Anthropic and/or OpenAI are the common pair (Azure OpenAI, Google, and Custom are also available).
2. Give it an optional Display Name.
3. Paste an API key for that provider, pick a Default Model, and set a Priority (lower runs first).
4. Toggle Allow passthrough on for BYOK.

Allow passthrough is a permission gate, not a billing switch. When it's on, clients may route through this provider using their own credentials — the key their tool sends is forwarded verbatim and never stored. When it's off, only the stored key is used.

Each provider row has its own enable/disable and passthrough toggles, so you can flip them later without removing the provider.

3. Attach blueprints

Open the Blueprints tab. Check the blueprints you want this gateway to inject, and set a Priority on each (lower priority injects first). Only blueprints that already exist in your org appear here — analyze a repository first if the list is empty.

4. (Optional) Attach policies

Open the Policies tab and check any org policies you want enforced. For each attached policy, choose an enforcement level:

• Enforce — block violating requests.
• Warn — log the violation but pass the request through.
• Disabled — attached but inactive.

5. Get the gateway URL and a key

Your gateway is reachable at:

https://gateway.unyform.ai/gw/<gateway-id>

The Setup tab shows ready-to-paste snippets and auto-mints a gateway API key (prefixed uny_gw_) the first time you open it — copy it then, because the plaintext is shown only once.

To mint additional keys for CI or key-authenticated endpoints, use the API Keys tab → Generate Key. Revoke them there too.

6. Point your tools at it

Set your tool's base URL to the gateway and run as usual:

The gateway speaks each provider's native protocol:

See Point Claude Code at your gateway for per-project config and the count_tokens preflight.

7. Verify and manage

Make a request that touches your codebase's domain, then check Dashboard → Audit to confirm blueprints were injected and policies ran.

To take a gateway offline, deactivate or delete it from the General tab.