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

# Introduction

> Base URL and authentication for the Empirical API

The Empirical API lets you trigger and inspect test runs, manage snoozes, browse test cases and environments, and pull analytics.

## Base URL

All endpoints are served from:

```
https://api.empirical.run
```

## Authentication

Every endpoint requires a Bearer token. Generate an API key from the [dashboard](https://dash.empirical.run/settings/api-keys), then send it in the `Authorization` header:

```bash theme={null}
Authorization: Bearer $EMPIRICALRUN_KEY
```

## Versioning

The Empirical API is versioned in the path (for example `/api/v1/…` and `/api/v2/…`). When an endpoint changes in a backwards-incompatible way, we publish it under a new version path and keep the previous one available. Deprecated endpoints keep working for backwards compatibility.

You can delegate migration to latest endpoints by sharing [openapi.deprecated.json](https://api.empirical.run/openapi.deprecated.json) with your coding agent. The spec documents latest endpoints that supersede deprecation.

The current latest reference is also available as a spec at [openapi.json](https://api.empirical.run/openapi.json).