OpenAPI
Per-app OpenAPI specs live with the app codebases. This page indexes them.
Status: Phase B/C — specs are being generated app-by-app as REST surfaces stabilize.
Current state
| App | Spec location | Status |
|---|---|---|
| Camino | camino/static/openapi.json | IN PROGRESS |
| Colectiva | colectiva/static/openapi.json | IN PROGRESS |
| Constanza | constanza/static/openapi.json | IN PROGRESS |
| Agente | — | Not yet generated |
| Caracol | — | Not yet generated |
| Mancha | — | Not yet generated |
| Agora | — | Not yet generated |
| Cookie Monster | — | Not yet generated |
| Patadas | — | Not yet generated |
Tooling
Specs are generated from the SvelteKit/Next.js server code using route introspection. The canonical generation command lives in each app's package.json as npm run openapi:generate.
Consuming
Until live spec URLs are published, rely on the per-app docs under /apps/ for the authoritative endpoint surface. OpenAPI URLs will be announced here as each app ships.
Roadmap
- Phase B (in progress): T1 apps ship live OpenAPI URLs
- Phase C: T2 apps ship live OpenAPI URLs + this page becomes a live index with click-through to Swagger UI
Source of truth
- Each app's
static/openapi.jsononce published - Per-app reference pages under /apps/