API reference

The full OpenAPI specification ships in the package at docs/openapi.yaml. The routes below are the ones most used.

RouteMethodPurpose
/api/healthGETLiveness and version.
/api/policiesGETList policies.
/api/policies/hotPUTUpdate a policy and reload it without a restart.
/api/policies/:category/:namePUTHot-reload a single policy.
/registry/agent/:agentId/heartbeatPUTAgent heartbeat, with ownership verification.

Tier promotions

Promotions are validated against the TierPromotion schema in docs/openapi.yaml. The accepted tier set is T0 through T4.