API Reference

The Karios Core API is served under /api/v2. It is described by an OpenAPI specification generated from the backend source and enriched with hand-written examples maintained in api/examples/.

Get the raw specification

The full OpenAPI specification is served at a stable URL for anyone generating their own client:

The specification is refreshed on every doc-site build, so the version served matches the tag pages below.

By tag

The pages below are generated into this site and are covered by the documentation search.

Regenerating

These pages are build output. To refresh them after a backend change:

./api/scripts/sync-specs.sh karios-core /path/to/karios-core
python3 api/scripts/inject_examples.py karios-core
python3 api/scripts/build_sphinx_pages.py karios-core

See api/README.md for the full pipeline, including how to add an example.