API Reference
Every operation Fallen-8’s controllers expose, rendered from its OpenAPI document. The health
probes and the Prometheus scrape endpoint (GET /healthz, GET /readyz, GET /metrics) are
mapped outside MVC and so never enter that document; they are documented on
Observability. For the versioning scheme, authentication, and an
endpoint map with prose, see REST API.
The document is exported while this site is built, so it describes the contract rather than a
reachable instance: its server list records the export host, and the default deny-all CORS policy blocks a browser call
from this site to your own server (Security). To send real requests,
run the app and use its bundled Scalar UI at /scalar/v0.1 (Development only). The raw document
is published at openapi/v0.1.json.
The interactive API reference renders from the OpenAPI document at/openapi/v0.1.json, which is generated in CI and published with the deployed site. It is not present in this build.
To browse the API locally, run the app and open its bundled Scalar reference:
dotnet run --project fallen-8-core-apiApp
# Scalar UI: http://localhost:5000/scalar/v0.1
# OpenAPI JSON: http://localhost:5000/openapi/v0.1.json