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

# Dashboard API

> The dashboard's own HTTP API: sessions, workspaces, live events, datasets, notebooks, RL

The dashboard is a FastAPI service in front of the controlplane, at `https://levers9-api.uselevers.com` for the lab
(`http://localhost:8100` locally). Its interactive reference is served by the API itself at `/docs`. It is what
the web app calls; anything the UI does can be scripted against it with the session cookie, and a few routes are
public.

| area | routes | | | | | | |
| - | - | - | - | - | - | - | - |
| health | `GET /health`: controlplane reachability and the connection details the SDK needs | | | | | | |
| sign-in | `GET /auth/login`, `/auth/callback`, `POST /auth/logout`, `GET /auth/me`, `POST /auth/switch` (workspace or environment), `POST /auth/workspaces`, `GET/POST /auth/workspaces/{id}/members`, `POST/DELETE /auth/environments`, `GET /auth/cli/start`, `GET /auth/cli/token` | | | | | | |
| live | `GET /events`: server-sent snapshots of tasks, containers, workers and deployments every two seconds | | | | | | |
| apps | `GET /api/apps/overview`, `/api/apps/{id}/overview`, `POST /api/apps/{id}/stop`, `/api/tasks`, `/api/tasks/{id}/subscribe`, \`/api/deployments/{id}/start | stop`, `/api/containers/{id}/attach`(live output),`/logs\` | | | | | |
| resources | `/api/workspace`, `/api/workers`, `/api/pools`, \`/api/volumes/{name}/ls | file | download | references`, `/api/secrets`, `/api/metrics/summary | timeseries\` | | |
| notebooks | `GET/POST /api/notebooks`, `PATCH /api/notebooks/{id}` (profile; relaunches), `/start`, `/stop`; the notebook server is proxied at `/nb/{slug}/…` | | | | | | |
| models | `/api/models/featured`, `/api/models/search`, `GET/POST /api/endpoints`, `/start`, `/stop` | | | | | | |
| datasets | `/api/datasets`, \`/{id}/rows | labels | export.tsv | import | prelabel | rerun | cancel`, `/{id}/shares`, `/{id}/nda`; public `/api/share/{token}/…\` for annotators |
| decision gold sets | on a dataset of kind `decision`: `GET /api/datasets/{id}/export.jsonl?status=validated&twins=1` (the gold set, one JSON object per line, with a twin record for every counterfactual) and `GET /api/datasets/{id}/schema.json` (the questions as a decision-model schema). `POST /api/datasets/{id}/labels` takes the label kinds `answers`, `unsure`, `causes`, `counterfactual`, `outcome`, `action` and `rationale`, and answers `422` for an unknown field, option or event id. See [Decision gold sets](https://levers9.mintlify.site/lab/decision-gold-sets.md) | | | | | | |
| RL | `/api/rl/agent/{tenant}/reply` (the inference layer, `X-Levers-Webhook-Key`) and `/agent/{tenant}/stats`, `/api/rl/calls` (and `/calls/webhook/{tenant}` with `X-Levers-Webhook-Key`), `/violations`, `/scenarios`, `/scenarios/map`, `/compare`, `/preferences`, `/preferences/freeze`, `/train`, `/evals`, `/policies`, `/policies/{id}/live`, `/packs`, `/jobs/{id}` | | | | | | |

The controlplane's own REST API, for what you deploy, is on the [API overview](https://levers9.mintlify.site/api-reference/overview.md).


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