Receiving "DataPlaneRedirectError" on API requests
Last updated: December 11, 2025
This issue is applicable to customers matching these conditions
Plans: Enterprise
Deployments: Hybrid
Use case: Making requests to the Braintrust API while using hybrid deployment
Issue
The following error is being returned when making requests to the Braintrust API:
Error: {"Code": "DataPlaneRedirectError", "Message": "Your organization <orgName>" is configured to use a different data plane. Please direct your requests to: <yourDataPlaneURL>"}
Cause
This error is thrown whenever the Control Plane UI of an organization is configured to point at a Hybrid Data plane, but a request is made to the Braintrust Hosted API URL instead.
Resolution
Make sure the API URL matches the data plane you intend to use. If you'd like to use braintrust with a hybrid data plane you'll need to:
Update your code to point to the API URL that is configured for your hybrid data plane. It should already be the same URL that is returned in the error message.
If the URL returned in the error is not the correct one for your hybrid data plane, check to make sure you are using the right API authentication key.
Is the "<orgName>" organization listed in the error the one you intend to make requests to? That is the organization you are authenticated as in your current request.
Do not update the API URL under Settings > Data Plane in the Control Plane (UI) unless you know this to be misconfigured. That will make all the current data visible in the UI no longer accessible by swapping to a different backend.