Beta module namespace
eventing
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.
19 operations
| Method | Path | Required permission | Authentication | Summary |
|---|---|---|---|---|
| get | /v1/m/eventing/dead-letters | eventing:delivery:read | Bearer token | eventing module route (requires eventing:delivery:read) |
| get | /v1/m/eventing/deliveries | eventing:delivery:read | Bearer token | Lists delivery state, optionally filtered by ?subscription, ?status (status=dead is the DLQ view), ?origin (live|replay) and ?event_type. |
| post | /v1/m/eventing/deliveries/{id}/redeliver | eventing:subscription:admin | Bearer token | Requeues ONE delivery that already reached a terminal state (delivered, dead or denied — the DLQ drain primitive). |
| get | /v1/m/eventing/egress-policy | eventing:subscription:read | Bearer token | Reports whether a destination policy is in force here, and what this deployment's disposition for the control is. |
| post | /v1/m/eventing/egress-policy/check | eventing:subscription:read | Bearer token | Answers "would this destination be permitted", without creating anything. |
| get | /v1/m/eventing/egress-policy/compat | eventing:subscription:admin | Bearer token | eventing module route (requires eventing:subscription:admin) |
| get | /v1/m/eventing/event-types | eventing:subscription:read | Bearer token | Returns the public event-type catalog: the subscribable types, their stability tier and the permission gating receipt. |
| get | /v1/m/eventing/events | eventing:event:read | Bearer token | Lists the tenant's captured event log from a seq cursor — the pull-side companion of replay (find your cursor, inspect what a delivery carried). |
| get | /v1/m/eventing/subscriptions | eventing:subscription:read | Bearer token | Lists the tenant's subscriptions. |
| post | /v1/m/eventing/subscriptions | eventing:subscription:write | Bearer token | Creates a subscription. |
| get | /v1/m/eventing/subscriptions/{id} | eventing:subscription:read | Bearer token | Returns one subscription (never its secret). |
| put | /v1/m/eventing/subscriptions/{id} | eventing:subscription:write | Bearer token | Updates a subscription in place. |
| delete | /v1/m/eventing/subscriptions/{id} | eventing:subscription:admin | Bearer token | Removes a subscription. |
| post | /v1/m/eventing/subscriptions/{id}/replay | eventing:subscription:admin | Bearer token | Re-enqueues deliveries for the subscription from a seq cursor: every retained event with seq >= from_seq (and <= to_seq, if set) that matches the subscription's type list and source filter gets a NEW queued delivery row (origin=replay). |
| post | /v1/m/eventing/subscriptions/{id}/restore | eventing:subscription:write | Bearer token | Re-applies the delivery shape of an earlier revision to an EXISTING subscription. |
| get | /v1/m/eventing/subscriptions/{id}/revisions | eventing:subscription:read | Bearer token | Lists a subscription's revision ledger, keyset-paginated by the time-ordered row id (chronological by ingestion, the decision-ledger convention). |
| post | /v1/m/eventing/subscriptions/{id}/rotate-auth | eventing:subscription:write | Bearer token | Replaces the subscription's auth credential, returning the old hint (the new cleartext is never returned — it is supplied by the caller). |
| post | /v1/m/eventing/subscriptions/{id}/rotate-secret | eventing:subscription:write | Bearer token | Replaces the subscription's signing secret, returning the new cleartext exactly once. |
| post | /v1/m/eventing/subscriptions/{id}/test | eventing:subscription:admin | Bearer token | Sends ONE synthetic "eventing.test" delivery to the subscription's endpoint, synchronously, signed with its real secret — the integrator's "is my receiver wired correctly?" probe. |