Passthrough plugin
The Passthrough plugin lets a client call an LLM provider with its own credentials (“bring your own key”) through a route that has no connection. The client names the provider, the provider’s origin, and the path in X-Fabric-* request headers. The gateway checks them, calls that origin, and relays the answer. It removes every X-Fabric-* header before it forwards the request.
Where it runs
A passthrough call has no connection, so connection settings don’t apply: no timeout, retry, failover, or allowed models list. The plugin asks for one attempt. With signed credentials (AWS SigV4 or a Google token), the gateway can retry once against the same origin.
Configuration
The plugin has no configuration, and an instance with any configuration is rejected. The client supplies everything in request headers:
Vertex AI, Azure OpenAI, and Bedrock accept only POST requests. For API-key providers, the integration catalog decides the allowed methods. A missing or invalid header gets 400 with a plain-text reason. A missing credential gets 401 in the provider’s error format.
The console’s create-route form requires a connection, so you can’t create a route with no connections there. Create the route with the admin API.
Example
Set up the plugin
Add a Passthrough instance to an LLM route so that callers can bring their own provider credentials.
Prerequisites
Before you begin, make sure you have the following:
- An LLM route with no connections. The control plane rejects the instance on a route of another protocol, or on a route that has a connection.
- An authentication plugin on the route, such as Key Auth. Without one, anonymous callers can use the route.
- The callers’ own provider credentials. The gateway never fills them in from stored credentials.
Add the instance
To add a Passthrough instance, do the following:
- In the sidebar, select Plugins.
- On the All tab, find Provider Passthrough, and then select Use. The New plugin instance form opens. The plugin applies only to routes, so the form has no Apply to field.
- In the field labeled Routes, select the route. If you select more than one, Fabric creates one instance for each and the name field becomes Base name.
- In Instance name, enter a name, for example
byok. - Review Request header contract. It lists the headers that callers send for each provider. The plugin has no configuration, and Edit as JSON isn’t available.
- Make sure Enabled is selected, and then select Create instance.
Verify the plugin
To confirm the route, send a request with the provider headers. This example calls Azure OpenAI:
Expect the provider’s response, for example 200. In Traces, the request appears on the route. The gateway removes every X-Fabric-* header before it calls the provider.

