Connecting Braintrust to Bigspin lets you pull traces and experiment logs from your Braintrust workspace directly into Bigspin projects. Once the integration is active, you can create projects sourced from Braintrust, apply metadata filters to narrow which traces are ingested, and let Bigspin handle the rest automatically — no manual exports required.
Connect your Braintrust account
Open Integrations settings
In the Bigspin dashboard, go to Settings > Integrations.
Select Braintrust
Click the Braintrust card to open the connection form.
Enter your API key
Paste your Braintrust API key into the field. Braintrust API keys follow the format:If you don’t have a key yet, follow the Braintrust authentication guide to generate one. Validate and connect
Bigspin validates the key against your Braintrust account before saving. If validation succeeds, the integration appears as connected on the Integrations page.Validation happens automatically when you submit the form. Bigspin does not store your key until the check passes.
Create a project with Braintrust as the data source
Once the integration is connected, you can create Bigspin projects that pull from your Braintrust workspace.
Go to Projects
Navigate to Projects in the Bigspin dashboard.
Open Data Sources
Click Data Sources when setting up a new project.
Select Braintrust
Choose Braintrust from the list of available sources.
Apply metadata filters (optional)
Bigspin fetches the metadata keys available in your Braintrust workspace and displays them in a filter panel. For each key you want to filter on:
- Select the metadata key from the dropdown.
- Choose or type the value to match. Bigspin shows sample values pulled from your workspace to help you pick the right one.
- Review the preview count — Bigspin shows how many traces match your current filter combination before you finalize the project.
Use metadata filters to scope ingestion to a specific experiment, model version, or environment. Narrowing the filter set keeps your project focused and speeds up analysis.
Finish creating the project
Complete the remaining project setup steps. Bigspin begins ingesting matching Braintrust traces automatically.
Ongoing ingestion
After initial setup, Bigspin ingests traces from Braintrust automatically. You do not need to trigger syncs manually or re-export data from Braintrust.
If you rotate your Braintrust API key, return to Settings > Integrations and update the key so ingestion continues without interruption.
