17 available actions

What your AI agent can do in Braintrust

Braintrust is an AI engineering platform for managing prompts, datasets, experiments, evaluations, observability, and production AI applications. This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.

Common starting points

Get Braintrust ResourceGet one project, experiment, dataset, prompt, or function by UUID.
Query Braintrust DataRun one bounded synchronous read-only BTQL query over Braintrust project logs, an experiment, or a dataset.
Create DatasetCreate a named dataset under a Braintrust project, or return the existing dataset unchanged when its name already exists in that project.
Create ExperimentCreate an experiment under a Braintrust project.
Update DatasetUpdate the name, description, tags, or metadata of a Braintrust dataset.
Update ExperimentUpdate selected metadata and linkage fields on a Braintrust experiment.

Browse all 17 actions by capability

Open a capability to see every supported action and its description.

Find & reviewLook up and review existing recordsView 4 actionsHide actions

Fetch EventsFetch one newest-to-oldest page of project log, experiment, or dataset events.
Get Braintrust ResourceGet one project, experiment, dataset, prompt, or function by UUID.
List Braintrust ResourcesList and filter one page of projects, experiments, datasets, prompts, or functions visible to the connected Braintrust API key.
Query Braintrust DataRun one bounded synchronous read-only BTQL query over Braintrust project logs, an experiment, or a dataset.

Create & communicateCreate records or send supported messagesView 4 actionsHide actions

Create DatasetCreate a named dataset under a Braintrust project, or return the existing dataset unchanged when its name already exists in that project.
Create ExperimentCreate an experiment under a Braintrust project.
Create ProjectCreate a Braintrust project, or return the existing project unchanged when its name already exists.
Create PromptUpsert a versioned prompt configuration under a Braintrust project without invoking it.

Update & manageChange and manage existing recordsView 4 actionsHide actions

Update DatasetUpdate the name, description, tags, or metadata of a Braintrust dataset.
Update ExperimentUpdate selected metadata and linkage fields on a Braintrust experiment.
Update ProjectUpdate selected fields of a Braintrust project.
Update PromptUpdate a Braintrust prompt's metadata or configuration without invoking it.

Remove & cancelRemove records or cancel supported workView 2 actionsHide actions

Delete ProjectSoft-delete a Braintrust project and return its deletion state.
Delete Experiment, Dataset, or PromptDelete one Braintrust experiment, dataset, or prompt by UUID for explicit lifecycle cleanup.

Other actionsSpecialist and administrative actions.View 3 actionsHide actions

Insert Dataset EventsUpsert a batch of examples into an existing Braintrust dataset.
Insert Experiment EventsUpsert a batch of result events into an existing Braintrust experiment.
Summarize Experiment or DatasetReturn metadata and optional aggregate summaries for one Braintrust experiment or dataset.

Connection record

A connection you can control.

Sign-in: Customer-managed key
Setup: Use a key you create and control. It is stored securely and limited to the work agreed for the role.
Boundaries: Only the approved role and actions.
Off switch: Revoke the connection from your account.

FAQ

Before you connect Braintrust

How does the agent connect to Braintrust?

With a key you create and control. It is stored securely, permissions are limited to what the agent needs, and you can revoke it at any time.

What can the agent actually do in Braintrust?

The page above lists the 17 actions currently available through the Braintrust connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.

Is Braintrust included in my plan?

Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.

How long until Braintrust is ready?

Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.

Bring the workflow together

Ready to put Braintrust to work?

Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.

Book a setup call Browse all connections

All product names, logos, and brands are property of their respective owners and are used for identification only. ZeroToClaw is not affiliated with or endorsed by Braintrust.