Beta module namespace
notify
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/notify/deliveries | notify:delivery:read | Bearer token | Lists the append-only delivery ledger, optionally filtered by ?status, ?finding_kind, ?destination and ?route (a route id). |
| get | /v1/m/notify/destinations | notify:route:read | Bearer token | Returns the provisioned destination names (from the wired transport). |
| get | /v1/m/notify/match-types | notify:route:read | Bearer token | Returns the routable event types a route's match_types may name — the console's multiselect source and the reference the validation errors point at. |
| get | /v1/m/notify/outbox | notify:delivery:read | Bearer token | Lists the durable outbox, optionally filtered by ?status (e.g. status=dead for the dead-letter queue view) and ?destination. |
| post | /v1/m/notify/outbox/{id}/redeliver | notify:route:admin | Bearer token | Requeues a TERMINAL outbox row (dead-letter drain / ack-and- retry). |
| get | /v1/m/notify/routes | notify:route:read | Bearer token | Lists routing rules, optionally filtered by ?destination and ?enabled. |
| post | /v1/m/notify/routes | notify:route:write | Bearer token | Declares a routing rule. |
| post | /v1/m/notify/routes/evaluate | notify:route:read | Bearer token | Answers "which routes would this signal select?" without delivering anything. |
| get | /v1/m/notify/routes/{id} | notify:route:read | Bearer token | Returns one route. |
| put | /v1/m/notify/routes/{id} | notify:route:write | Bearer token | Replaces a route's predicate, destination and windows. |
| delete | /v1/m/notify/routes/{id} | notify:route:admin | Bearer token | Removes a route (hard delete). |
| post | /v1/m/notify/routes/{id}/restore | notify:route:write | Bearer token | Re-applies the configuration of an earlier revision to an EXISTING route (never the name — the natural key, exactly like update). |
| get | /v1/m/notify/routes/{id}/revisions | notify:route:read | Bearer token | Lists a route's revision ledger, keyset-paginated by the time-ordered row id (chronological by ingestion, the decision-ledger convention). |
| post | /v1/m/notify/routes/{id}/test | notify:route:admin | Bearer token | Sends a synthetic test notification through a route's destination and records the attempt in the ledger. |