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.