> ## Documentation Index
> Fetch the complete documentation index at: https://docs.braintrust.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Reference

> Technical reference for the Braintrust API, CLI, Terraform provider, and SQL syntax

## API

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

> [card] [API overview](https://docs.braintrust.dev/api-reference.md)
>
> Authentication, resources, and common tasks

> [card] [API resources](https://docs.braintrust.dev/api-reference/projects/list-projects.md)
>
> Complete endpoint reference with examples

> [card] [Query by SQL](https://docs.braintrust.dev/api-reference/query.md)
>
> Query logs, experiments, and datasets with SQL over HTTP

## CLI

> [card] [CLI quickstart](https://docs.braintrust.dev/reference/cli/quickstart.md)
>
> Install the bt CLI and run your first eval

> [card] [CLI commands](https://docs.braintrust.dev/reference/cli/overview.md)
>
> Complete command reference with flags and environment variables

## Terraform

> [card] [Terraform provider](https://docs.braintrust.dev/reference/terraform.md)
>
> Manage projects, permission groups, access, prompts, and functions as code

## SQL

> [card] [Overview](https://docs.braintrust.dev/reference/sql.md)
>
> Query logs, experiments, and datasets with SQL from the sandbox, CLI, or API

> [card] [Filtering](https://docs.braintrust.dev/reference/sql/filtering.md)
>
> What a filter matches on each query shape, and common pitfalls to avoid

> [card] [Query structure](https://docs.braintrust.dev/reference/sql/query-structure.md)
>
> Clauses, data sources, data shapes, aggregations, and field access

> [card] [Functions and operators](https://docs.braintrust.dev/reference/sql/functions.md)
>
> The function and operator catalog with definitions and examples

> [card] [Examples](https://docs.braintrust.dev/reference/sql/examples.md)
>
> Copy-and-run queries for tokens, cost, quality, errors, and more

> [card] [Best practices](https://docs.braintrust.dev/reference/sql/best-practices.md)
>
> Write SQL queries that return correct results and run fast


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.