Skip to main content

API

The Braintrust API provides programmatic access to all platform features through a REST interface:

API overview

Authentication, resources, and common tasks

API resources

Complete endpoint reference with examples

CLI

CLI quickstart

Install the bt CLI and run your first eval

CLI commands

Complete command reference with flags and environment variables

SQL

Overview

Query logs, experiments, and datasets with SQL from the sandbox, CLI, or API

Query structure

Clauses, data sources, data shapes, aggregations, and field access

Functions and operators

The function and operator catalog with definitions and examples

Examples

Copy-and-run queries for tokens, cost, quality, errors, and more

Best practices

Write SQL queries that return correct results and run fast