API reference
The full OpenAPI specification ships in the package at docs/openapi.yaml. The routes below are the ones most used.
| Route | Method | Purpose |
|---|---|---|
/api/health | GET | Liveness and version. |
/api/policies | GET | List policies. |
/api/policies/hot | PUT | Update a policy and reload it without a restart. |
/api/policies/:category/:name | PUT | Hot-reload a single policy. |
/registry/agent/:agentId/heartbeat | PUT | Agent 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.