WorldForge Studio

01 — Health, settings & ops

Liveness probes, user settings, the AI pixel analyzer, and test-only audit fixtures.

Health

MethodPathNotes
GET/healthzLiveness — 200 when the process is up
GET/healthz/readyzReadiness alias
GET/readyzReadiness (DB/migrations)
GET/readyz/readyzReadiness alias
GET/api/healthHealth JSON for the workspace deploy
GET/api/health/readyzReadiness JSON

No auth — probes must work for the load balancer.

/api/settings — user LLM settings

MethodPathNotes
GET/api/settings/llm-keyWhich providers are configured
PUT/api/settings/llm-keySave a provider key (SSRF-guarded base_url)
DELETE/api/settings/llm-key/:providerRemove it
GET/api/settings/llm-key/prefsNon-secret preferences
PUT/api/settings/llm-key/prefsUpdate preferences

User session only (requireUserSession) — API keys are refused.

/api/analyze — pixel analyzer

MethodPathNotes
POST/api/analyze/pixelAnalyze an image's palette/pixels (asset pipeline)

User session only.

/api/audit — test fixtures

MethodPathNotes
POST/api/audit/grant-roleGrant a user_roles row (CI/E2E seeding)
POST/api/audit/seed-print-shopSeed 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.