Braintrust

Create a named dataset under a Braintrust project, or return the existing dataset unchanged when its name already exists in that project.

Create an experiment under a Braintrust project. When its name already exists, Braintrust returns the existing experiment unchanged unless ensure_new is true, which creates an experiment with a unique

Create a Braintrust project, or return the existing project unchanged when its name already exists.

Upsert a versioned prompt configuration under a Braintrust project without invoking it. The same project and slug reuse the prompt ID but create a new version that replaces the stored prompt configura

Soft-delete a Braintrust project and return its deletion state.

Delete one Braintrust experiment, dataset, or prompt by UUID for explicit lifecycle cleanup.

Fetch one newest-to-oldest page of project log, experiment, or dataset events.

Get one project, experiment, dataset, prompt, or function by UUID.

Upsert a batch of examples into an existing Braintrust dataset. New or omitted IDs insert events; an existing supplied ID replaces that event's current values.

Upsert a batch of result events into an existing Braintrust experiment. New or omitted IDs insert events; an existing supplied ID replaces that event's current values.

List and filter one page of projects, experiments, datasets, prompts, or functions visible to the connected Braintrust API key.

Run one bounded synchronous read-only BTQL query over Braintrust project logs, an experiment, or a dataset. The first-page query must end with a positive LIMIT; continue later pages by passing the ret

Return metadata and optional aggregate summaries for one Braintrust experiment or dataset.

Update the name, description, tags, or metadata of a Braintrust dataset. At least one non-null mutable field is required.

Update selected metadata and linkage fields on a Braintrust experiment. At least one non-null mutable field is required.

Update selected fields of a Braintrust project. At least one non-null mutable field is required: name, description, or settings.

Update a Braintrust prompt's metadata or configuration without invoking it. At least one non-null mutable field is required.