API5 min

Webhooks

Subscribe to promotion, approval, and incident events. Delivery matches the mock components on Status.

Event types

EventWhen
session.openedPromotion session created
session.approvedApprover recorded
session.promotedRollout executed
session.rolled_backKill-switch / rollback
component.degradedControl-plane health drop

Payload sketch

{
  "id": "evt_9f2c",
  "type": "session.promoted",
  "createdAt": "2026-03-17T09:40:00Z",
  "data": {
    "sessionId": "ses_01",
    "environment": "prod-eu-west"
  }
}

Delivery

Retries use exponential backoff. Signatures are HMAC-SHA256 over the raw body. Verify with your shared secret before acting on promotions.