docs/schema/, and the download links below use Mint-served
text mirrors so local preview and production both offer a working file
download.
OpenAPI 3.1
The supervisor HTTP and SSE control plane is published as a raw OpenAPI document: Use this file with Swagger UI, Stoplight, Postman, or client generators. To regenerate it from the live supervisor schema:gc events JSONL Schema
gc events list/watch/follow output is published as a small JSON Schema that
references the OpenAPI DTO components instead of duplicating their fields:
Use this file to validate one JSON object line emitted by gc events,
gc events --watch, or gc events --follow. Cursor mode is intentionally
outside the JSON Schema because gc events --seq writes a plain-text cursor,
not JSONL.
For the explicit CLI output contract, including scope selection, empty-output
behavior, heartbeat suppression, and cursor formats, see
gc events Formats.
City Config JSON Schema
Thecity.toml configuration schema is also published as a raw JSON Schema
document:
Use this file for validation, editor integration, and external tooling. To
regenerate it: