Skip to main content
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

1

Open Integrations settings

In the Bigspin dashboard, go to Settings > Integrations.
2

Select Braintrust

Click the Braintrust card to open the connection form.
3

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.
4

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.
1

Go to Projects

Navigate to Projects in the Bigspin dashboard.
2

Open Data Sources

Click Data Sources when setting up a new project.
3

Select Braintrust

Choose Braintrust from the list of available sources.
4

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.
You can add multiple key/value filters. Bigspin applies them together, ingesting only traces that match all conditions.
5

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.