Realtime contract

Event schemas

The envelope is stable and version-independent from the payload topic.

{
  "sequence": 42,
  "occurredAt": "2026-08-27T...Z",
  "topic": "record.updated",
  "collection": "issues",
  "recordId": "rec_...",
  "payload": {"version": 3, "values": {}}
}

Current record topics are record.created, record.updated and record.deleted. Consumers must use the sequence for replay position and treat unknown payload fields as forward-compatible additions.

Authorization

Possessing an event ID is never authorization. Every new SSE connection re-enters the ordinary identity boundary. Applications should reconnect after credential rotation or policy changes.