API reference
Browse the core Silo endpoints without signing in. Auth requirements are called out on the page.
Industry-grade API docs
Endpoint groups organized by real operator workflows.
The public site and CLI both talk to these APIs. Health endpoints are separated from authenticated product endpoints so teams can reason about uptime, backend reachability, and data-layer degradation without guessing.
Auth model
Health and liveness endpoints used by monitors and deployment checks.
Accepts Cognito JWTs or user API keys unless otherwise documented.
System and health
Use these endpoints for uptime monitors, deployment diagnostics, and maintenance-mode signaling.
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/workspace-status | Public | Dedicated workspace availability endpoint. Drives the full-page unreachable state in the authenticated app. |
| GET | /api/health | Public | Frontend aggregate health endpoint. Reports frontend, backend, and database status for diagnostics. |
| GET | /api/system/health | Public | Backend deep health endpoint. Includes a lightweight Supabase probe. |
| GET | /health | Public | Backend liveness check for simple process health. |
Suites and prompts
Primary authoring endpoints for suites, prompt versions, and list views used by the dashboard and CLI.
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /api/suites | Bearer | Create a suite. |
| GET | /api/suites | Bearer | List suites for the current user. |
| POST | /api/suites/{id}/prompts | Bearer | Create a prompt version within a suite. |
| GET | /api/suites/{id}/prompts | Bearer | List prompt versions for a suite. |
Test cases
Persist and generate test cases before a run. Drift runs are centered on stored cases.
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /api/suites/{id}/test-cases | Bearer | Bulk create test cases. |
| GET | /api/suites/{id}/test-cases | Bearer | List test cases. |
| POST | /api/test-cases/generate | Bearer | Generate test cases with AI and persist them. |
Drift runs and gating
Execution, streaming, stored run inspection, and CI guardrails all route through this core group.
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /api/agent/run | Bearer | Run a synchronous drift evaluation. |
| POST | /api/agent/run/stream | Bearer | Run a streaming drift evaluation over SSE. |
| GET | /api/agent/runs/{run_id} | Bearer | Fetch a stored run result and diagnostics. |
| POST | /api/ci/gate | Bearer | Evaluate a run against CI thresholds. |