Skip to content

API reference

The gemba serve HTTP API is described by an OpenAPI 3 document.

  • Spec: /api/openapi.json
  • Source of truth: internal/server/openapi/openapi.json in the repo.
  • Lint: make lint-openapi (Spectral, ruleset at .spectral.yaml).
  • Regenerate the typed SPA client: make codegen.

Interactive API explorer (Swagger / Redoc / Stoplight Elements) is tracked in gm-e4.2. Until that lands, point your tooling directly at the JSON above.