01 — Health, settings & ops
Liveness probes, user settings, the AI pixel analyzer, and test-only audit fixtures.
Health
| Method | Path | Notes |
|---|---|---|
GET | /healthz | Liveness — 200 when the process is up |
GET | /healthz/readyz | Readiness alias |
GET | /readyz | Readiness (DB/migrations) |
GET | /readyz/readyz | Readiness alias |
GET | /api/health | Health JSON for the workspace deploy |
GET | /api/health/readyz | Readiness JSON |
No auth — probes must work for the load balancer.
/api/settings — user LLM settings
| Method | Path | Notes |
|---|---|---|
GET | /api/settings/llm-key | Which providers are configured |
PUT | /api/settings/llm-key | Save a provider key (SSRF-guarded base_url) |
DELETE | /api/settings/llm-key/:provider | Remove it |
GET | /api/settings/llm-key/prefs | Non-secret preferences |
PUT | /api/settings/llm-key/prefs | Update preferences |
User session only (requireUserSession) — API keys are refused.
/api/analyze — pixel analyzer
| Method | Path | Notes |
|---|---|---|
POST | /api/analyze/pixel | Analyze an image's palette/pixels (asset pipeline) |
User session only.
/api/audit — test fixtures
| Method | Path | Notes |
|---|---|---|
POST | /api/audit/grant-role | Grant a user_roles row (CI/E2E seeding) |
POST | /api/audit/seed-print-shop | Seed a print shop for flows |
Present so the screen-audit and E2E harnesses can arrange state. Guarded like the rest of the platform-admin surface; not part of the integration contract.