How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Braintrust Evals API

The Evals API from Braintrust — 1 operation(s) for evals.

Braintrust Evals API is one of 41 APIs that Braintrust publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Evals. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 1 operation across 1 path, and defines 26 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.braintrust.dev.

1 operations 1 paths 26 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.braintrust.dev
Authentication
HTTP Bearer
License
Apache 2.0
Resource Areas
1

Authentication & Security 1

Braintrust Evals API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (API key or JWT) (bearerAuth). By default, every request must be authenticated, though some operations may also be called without credentials.

  • bearerAuth — Most Braintrust endpoints are authenticated by providing your API key as a header Authorization: Bearer [apikey] to your HTTP request. You can create an API ke…

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Evals 1
POST
/v1/eval
Launch an eval
evalLaunch body → 200

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are RunEval (23 properties), RepoInfo (9 properties), SummarizeExperimentResponse (7 properties), PromptData (7 properties). Each schema is shown below with its type and property counts.

ChatCompletionContentPartText
object
3 properties 1 required
ChatCompletionContentPartFileWithTitle
object
2 properties 2 required
SummarizeExperimentResponse
object
Summary of an experiment
7 properties 4 required
PromptParserNullish
object
5 properties 2 required
InvokeParent
Options for tracing the function call
PromptBlockDataNullish
GitMetadataSettings
object
Optional settings for collecting git metadata. By default, will collect all git metadata fields allowed in org-level settings.
2 properties 1 required
ChatCompletionMessageToolCall
object
3 properties 3 required
ChatCompletionContentPartFileFile
object
3 properties
ChatCompletionMessageParam
ModelParams
ChatCompletionMessageReasoning
object
Note: This is not part of the OpenAI API spec, but we added it for interoperability with multiple reasoning models.
2 properties
ResponseFormatJsonSchema
object
4 properties 1 required
FunctionTypeEnum
string
The type of global function. Defaults to 'scorer'.
RepoInfo
object
Metadata about the state of the repo when the experiment was created
9 properties
ChatCompletionContentPart
ScoreSummary
object
Summary of a score's performance
5 properties 4 required
PromptOptionsNullish
object
3 properties
MetricSummary
object
Summary of a metric's performance
6 properties 5 required
SavedFunctionId
Optional function identifier that produced the classification
RunEval
object
23 properties 4 required
PromptData
object
7 properties
FunctionId
The function to evaluate
ChatCompletionContentPartImageWithTitle
object
2 properties 2 required
ResponseFormatNullish
ChatCompletionContentPartTextWithTitle
object
3 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

braintrust-evals-api-openapi.yml Raw ↑

Other APIs Braintrust publishes across the network.

Braintrust API
Braintrust Acls API
Braintrust AiSecrets API
Braintrust ApiKeys API
Braintrust CORS API
Braintrust CrossObject API
Braintrust Datasets API
Braintrust DatasetSnapshots API
Braintrust Environments API
Braintrust EnvVars API
Braintrust Experiments API
Braintrust Functions API
Where this information came from

This is an independent, third-party profile of Braintrust Evals API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.