API Reference

Endpoints registered by the mounted MCAT blueprint. Every path below is already prefixed with the mount point, so it can be called as shown.

Method Path Summary
GET /mcat/api/docs Endpoint reference for the mounted blueprint.
GET /mcat/api/health Basic health information about the MCAT system.
GET /mcat/api/live Whether the system is alive.
GET /mcat/api/ready Whether the system is ready to accept requests.
POST /mcat/api/v1/allocate Compute an allocation decision for a decision context.
POST /mcat/api/v1/allocate/batch Process multiple allocation decisions in one request.
GET /mcat/api/v1/decisions/<uuid:decision_id> Retrieve a previous allocation decision by id.
GET /mcat/api/v1/decisions/<uuid:decision_id>/audit Aggregate audit summary for a decision — no internal details.
GET /mcat/api/v1/decisions/<uuid:decision_id>/explain Human-readable explanation for a decision — categorical, never EFE.
POST /mcat/api/v1/decisions/<uuid:decision_id>/outcome Record the realised outcome of a decision, feeding AI learning.
POST /mcat/api/v1/decisions/<uuid:decision_id>/override Override a previous decision — creates a NEW approved decision.
GET /mcat/api/v1/governance/audit/events High-level audit event counts.
GET /mcat/api/v1/governance/audit/export Downloadable audit summary for the Audit page's Export button.
GET /mcat/api/v1/governance/audit/summary Aggregate audit trail summary.
GET /mcat/api/v1/governance/audit/verify Verify the audit hash chain without exposing its entries.
GET /mcat/api/v1/governance/boundary-crossings Recent boundary crossings (metadata only) for the visualization.
POST /mcat/api/v1/governance/calibrate Run parameter calibration from recorded outcomes.
GET /mcat/api/v1/governance/choice-metrics von Foerster choice-expansion metrics for the system.
GET /mcat/api/v1/governance/statistics Aggregate system statistics — no EFE scores or internal details.
GET /mcat/api/v1/scenarios All enabled scenarios (metadata, decision types, overrides, builtin flag).
DELETE /mcat/api/v1/scenarios/<key> Delete a user scenario (unregister + remove its file). Built-ins protected.
GET /mcat/api/v1/scenarios/<key> Export a scenario as canonical ScenarioConfig JSON (re-importable).
POST /mcat/api/v1/scenarios/import Validate, register, and persist a user scenario.
GET /mcat/api/v1/scenarios/schema JSON schema for a scenario file — the contract for imports.
GET /mcat/api/v1/session This session's request budget: quota spent, rate window, and expiry.

Request and response bodies are unchanged from the FastAPI implementation; the pydantic schemas in mcat_flask.schemas define them. Add ?scenario=<key> to any call to route it to that scenario's configured system.