Beta module namespace
health
Beta routes may change with notice and are NOT covered by the 24-month stable window of the core contract.
Every module route is enumerated with method, path, auth and required permission; request/response schemas are not published for the beta surface.
14 operations
| Method | Path | Required permission | Authentication | Summary |
|---|---|---|---|---|
| get | /v1/m/health/checks | health:check:read | Bearer token | Lists declared checks, optionally filtered by ?subject_kind and ?desired_status. |
| post | /v1/m/health/checks | health:check:write | Bearer token | Declares a monitored subject. |
| get | /v1/m/health/checks/{id} | health:check:read | Bearer token | Returns one check projected as status. |
| put | /v1/m/health/checks/{id} | health:check:write | Bearer token | Patches a check's configuration. |
| delete | /v1/m/health/checks/{id} | health:check:admin | Bearer token | Removes a check (hard delete). |
| post | /v1/m/health/checks/{id}/report | health:check:write | Bearer token | Ingests an active probe result for a check and folds it into the subject's health. |
| get | /v1/m/health/dependencies | health:status:read | Bearer token | Returns the dependency map as a React-Flow node+edge graph: a page of auto-discovered dependency edges, plus the deduplicated node set derived from them, each node annotated with its subject's health. |
| get | /v1/m/health/events | health:status:read | Bearer token | Lists the append-only reliability transition ledger, optionally filtered by ?subject_kind and ?subject_ref. |
| get | /v1/m/health/incidents | health:status:read | Bearer token | Lists incidents, optionally filtered by ?state (open| resolved), ?subject_kind and ?subject_ref. |
| get | /v1/m/health/incidents/{id} | health:status:read | Bearer token | Returns one incident. |
| post | /v1/m/health/incidents/{id}/resolve | health:check:admin | Bearer token | health module route (requires health:check:admin) |
| get | /v1/m/health/sla | health:status:read | Bearer token | Reports the reliability of a subject over a trailing window (?subject_kind=&subject_ref=&window_seconds=). |
| get | /v1/m/health/status | health:status:read | Bearer token | Lists the current health of monitored subjects (the check rows projected as status), optionally filtered by ?state and ?subject_kind. |
| get | /v1/m/health/stream | health:status:read | Bearer token | Serves live health changes as server-sent events, pinned to the request's single authorized tenant so a client only ever sees its own tenant's subjects. |