Skip to content

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

MethodPathRequired permissionAuthenticationSummary
get/v1/m/health/checkshealth:check:readBearer tokenLists declared checks, optionally filtered by ?subject_kind and ?desired_status.
post/v1/m/health/checkshealth:check:writeBearer tokenDeclares a monitored subject.
get/v1/m/health/checks/{id}health:check:readBearer tokenReturns one check projected as status.
put/v1/m/health/checks/{id}health:check:writeBearer tokenPatches a check's configuration.
delete/v1/m/health/checks/{id}health:check:adminBearer tokenRemoves a check (hard delete).
post/v1/m/health/checks/{id}/reporthealth:check:writeBearer tokenIngests an active probe result for a check and folds it into the subject's health.
get/v1/m/health/dependencieshealth:status:readBearer tokenReturns 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/eventshealth:status:readBearer tokenLists the append-only reliability transition ledger, optionally filtered by ?subject_kind and ?subject_ref.
get/v1/m/health/incidentshealth:status:readBearer tokenLists incidents, optionally filtered by ?state (open| resolved), ?subject_kind and ?subject_ref.
get/v1/m/health/incidents/{id}health:status:readBearer tokenReturns one incident.
post/v1/m/health/incidents/{id}/resolvehealth:check:adminBearer tokenhealth module route (requires health:check:admin)
get/v1/m/health/slahealth:status:readBearer tokenReports the reliability of a subject over a trailing window (?subject_kind=&subject_ref=&window_seconds=).
get/v1/m/health/statushealth:status:readBearer tokenLists the current health of monitored subjects (the check rows projected as status), optionally filtered by ?state and ?subject_kind.
get/v1/m/health/streamhealth:status:readBearer tokenServes 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.