This feature is available for select Enterprise customers only.
Overview
Gateway Registration connects your self-hosted AI Gateway to the Portkey Control Plane. Once registered, the Data Plane can pull promt templates, routing configs,integrations, API keys etc. The registration flow has three steps:- Register Gateway — provide a name, URL, and environment type
- Workspace Provisioning — choose which workspaces can use this gateway
- Save the deployment configuration — download and store the generated configuration for your deployment.
Step 1: Register Gateway
Navigate to Admin Settings → Gateway Registration and click Register New Gateway. Fill in the following fields:Step 2: Workspace Provisioning
Workspace Provisioning is available on the Hybrid Enterprise plan only.
Workspace Access Options
- Allow All Workspaces
- Allow Specific Workspaces
All current and future workspaces in your organisation can route traffic through this gateway. No further configuration is needed.
Step 3: Save the deployment configuration
Download thevalues.yaml configuration file generated for your deployment.
Gateway Overview
After registration, you can manage your gateway from Admin Settings → Gateway Registration → [Gateway Name]. The overview page shows:- Status badge (
active/inactive) — updated when you run Verify Connection. - Workspace Control tab — edit workspace access permissions after registration.
- Last Sync — elapsed time since the most recent sync between the data plane and control plane.
Disable the SaaS Gateway
The SaaS Gateway toggle at the top of the Gateway Registration page controls whether your organisation can send traffic to the Portkey SaaS gateway. Turn it off to route all traffic through your own registered gateways.
The toggle is available on all accounts. Only organisation admins can change it.
Disable or re-enable
1
Open Gateway Registration
Go to Settings > Organisation > Gateway Registration.
2
Confirm a registered gateway is active
Check that at least one registration shows an Active status.
3
Switch the SaaS Gateway toggle
Turn the SaaS Gateway toggle off to disable the SaaS gateway, or on to re-enable it.
Deployment Steps
For Helm chart deployment details, refer to the values.yaml reference.Connect to the Gateway
Once your gateway is running and registered, verify it is reachable and routing requests correctly.Portkey is now PRISMA AIRS AI Gateway. See it in action.
Contact Us

