API
OpenAPI spec
The machine-readable OpenAPI 3.1 document — import it into your tools.
The whole API is described by a machine-readable OpenAPI 3.1 document, generated from the server's own route schemas so it never drifts from the implementation.
Spec URL
/openapi/v1.json — the current document. The live server
also serves it at https://api.wardencore.ru/v1/openapi.json.
Use it
- Postman / Insomnia — Import → paste the spec URL to get a ready-made collection of every endpoint, with auth pre-wired.
- Code generation — feed it to openapi-generator or
openapi-typescriptto generate a typed client in your language. - Contracts — the document describes every response, including the shared error envelope (
400,401,403,404,409,429,500,503,504).
Endpoints roll out over time
The document lists the endpoints available today; it grows as we ship more. Pin to a version (/v1) and re-import after upgrades — within a version we only add fields.