Skip to content

Event

An Event is the immutable record of something that happened to a Thing, named by its Noun and past-tense Verb.

Metrics, Triggers and Watches read Events, so every number and every automation traces back to one.

Properties

PropertyTypeRequiredDescription
namestringrequiredThe Noun and the event form of its Verb, such as Order.placed.
atdatetimerequiredWhen it happened.
datajsonThe Thing as the Action left it.
seqintegerIts position in the namespace, one more than the Event before; any seq is a cursor into the history.

Object

JSON
{
  "$id": "https://api.sb/quietcopy.com/events/event_1",
  "$type": "Event",
  "name": "QuietCopy",
  "at": "2026-10-22T12:00:00Z",
  "data": {},
  "seq": 1
}

Relationships

  • An Event causes many Entries: every ledger Entry traces to the one Event that caused it, such as Order.paid. causes, inverse causedBy.
  • An Event is delivered by many Watches: a Watch delivers each matching Event to its URL, signed, retried and replayable. deliveredBy, inverse delivers.
  • An Event is emitted by one Action: a completed Action emits its Events, which Triggers, Watches and Metrics read. emittedBy, inverse emits.
  • An Event feeds many Metrics: a Metric derives from Events and is never typed in. feeds, inverse computedFrom.
  • An Event fires many Triggers: a Trigger fires each time an Event matching its selector happens. fires, inverse firesOn.
  • An Event is metered by many Meters: the Events the Meter counts toward usage billing. meteredBy, inverse counts.

Verbs

  1. createCreates an Event.
    POST /{namespace}/eventsdoEvent.created
  2. getReturns one Event by id.
    GET /{namespace}/events/{id}readNo Event
  3. listReturns Events, newest first, one page at a time.
    GET /{namespace}/eventsreadNo Event
  4. captureCapture records an Event from a Site, App or API call that no Verb emits, such as a page view or a click.
    POST /{namespace}/events/capturedoEvent.captured

An Event is kept forever and never edited: it has no update or delete.

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Event.createYesYesYesNo
Event.getYesYesYesYes
Event.listYesYesYesYes
Event.captureYesYesYesNo

Call it

Text
Capture the latest event.

Example

Invoice.paid records that Invoice 1042 was paid $49 at 14:02. It feeds the monthly recurring revenue Metric and fires the receipt Trigger, and no later Action alters it.