Skip to content

CloudEvents envelope

Each public event is one CloudEvents 1.0 structured JSON object. Webhook callbacks use the same object bytes, with no second payload wrapper.

Field Meaning
specversion Always 1.0
id Stable event identifier used for business-effect deduplication
source Always https://api.barakahtasks.com/events
type Versioned event type from the registry
subject Resource subject
time Capture time, recorded as recordedAt
datacontenttype Always application/json
barakahsequence External publication-order cursor
barakahpublishedat Time the committed event entered the external log
barakahresourceat Persisted resource timestamp when present
data Event-specific thin snapshot

The envelope rejects additional top-level properties. Use the versioned base schema and the per-event schemas in the event catalog as source truth.

Public V1 event data carries no mutation actor or mutation-source attribution. A List ownership transfer produces separate owner-specific thin events for the former and new owner, without counterparty identity.