> For the complete documentation index, see [llms.txt](https://docs.layerlens.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.layerlens.ai/13.1-sdk-and-apis/api.md).

# API reference (REST)

REST API reference — same surface the dashboard and SDK use.

Base URL: `https://stratix.layerlens.ai/api/v1`. Auth: `X-API-Key` header.

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Authentication</strong></td><td>API keys, scopes, rotation.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/auth.md">Read</a></td></tr><tr><td><strong>Models</strong></td><td>List, get models.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/models.md">Read</a></td></tr><tr><td><strong>Benchmarks</strong></td><td>List, get, upload benchmarks.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/benchmarks.md">Read</a></td></tr><tr><td><strong>Evaluations</strong></td><td>Create, get, list, compare.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/evaluations.md">Read</a></td></tr><tr><td><strong>Scorers</strong></td><td>Manage scorers.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/scorers.md">Read</a></td></tr><tr><td><strong>Judges</strong></td><td>Manage judges.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/judges.md">Read</a></td></tr><tr><td><strong>Judge optimizations</strong></td><td>Run GEPA.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/judge-optimizations.md">Read</a></td></tr><tr><td><strong>Traces</strong></td><td>Ingest and browse.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/traces.md">Read</a></td></tr><tr><td><strong>Trace evaluations</strong></td><td>Score trace sets.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/trace-evaluations.md">Read</a></td></tr><tr><td><strong>Spaces</strong></td><td>Manage spaces.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/spaces.md">Read</a></td></tr><tr><td><strong>Notifications</strong></td><td>Subscribe to events.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/notifications.md">Read</a></td></tr><tr><td><strong>Webhooks</strong></td><td>Receive events.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/webhooks.md">Read</a></td></tr><tr><td><strong>Organizations</strong></td><td>Multi-org and members.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/organizations.md">Read</a></td></tr><tr><td><strong>API keys</strong></td><td>Manage keys.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/api-keys.md">Read</a></td></tr><tr><td><strong>BYOK custom models</strong></td><td>Register endpoints.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/byok-models.md">Read</a></td></tr><tr><td><strong>Errors</strong></td><td>Status codes and bodies.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/errors.md">Read</a></td></tr><tr><td><strong>Rate limits</strong></td><td>Limits and headers.</td><td><a href="https://github.com/LayerLens/gitbook-full/blob/main/13-reference/api/rate-limits.md">Read</a></td></tr></tbody></table>

## Conventions

* **Pagination** — cursor-based: `?cursor=...&page_size=...`
* **Versioning** — `/api/v1` prefix; breaking changes get a `/v2`
* **Async work** — POST returns a handle (with status), GET fetches updated state, helpers wait
* **Request IDs** — every response has `X-Request-ID`