Skip to content

Every event that can start a flow

A flow begins when something happens. These are the moments the platform declares, which is the whole list: a flow can subscribe to one of these and to nothing else.

Each event carries pins, the typed values it hands your flow. A pin holds a reference or a fact, never a document and never a person’s details, which is why the value types here are only text, number and yes/no.

11 events are declared.

A case was opened, from a telematics alert or an ingested email.

Subscribe tocase-opened
Narrow it bykind, so a flow reacts to one kind rather than all of them

What it hands your flow

PinTypeWhat it is
caseIdstringThe case this event is about.
codestringThe case reference shown to people.
caseTypeCodestringThe case’s own TYPE code, distinct from kind (the alert/report vocabulary): lets a flow narrow to one vertical’s cases directly. ” for a case no published type claimed.
kindstringWhat kind of alert opened it.
channelstringHow it arrived (‘alert’, ‘inbox’, ‘report’), as distinct from what kind it was.
severitystringSeverity as reported, before any grading.
vehicleRefstringReference to the vehicle. Resolve for detail; never a plate here.
occurredAtstringISO instant the underlying event happened.

A severity grade was recorded on a case, by a person or by a flow.

Subscribe tocase-severity-graded
Narrow it byseverity, so a flow reacts to one kind rather than all of them

What it hands your flow

PinTypeWhat it is
caseIdstringThe case this event is about.
codestringThe case reference shown to people.
caseTypeCodestringThe case’s own TYPE code, distinct from kind (the alert/report vocabulary): lets a flow narrow to one vertical’s cases directly. ” for a case no published type claimed.
kindstringWhat kind of alert opened the case.
severitystringThe grade that was recorded.
vehicleRefstringReference to the vehicle.
occurredAtstringISO instant the underlying event happened.

A case moved along its kind’s own process, by the verb its author wrote.

Subscribe tocase-stage-moved
Narrow it byto, so a flow reacts to one kind rather than all of them

What it hands your flow

PinTypeWhat it is
caseIdstringThe case this event is about.
codestringThe case reference shown to people.
caseTypeCodestringThe case’s own TYPE code, distinct from kind (the alert/report vocabulary): lets a flow narrow to one vertical’s cases directly. ” for a case no published type claimed.
tostringThe stage the case moved INTO, by its authored id.
fromstringThe stage it left.
fromLabelstringWhat the author calls the stage it left.
toLabelstringWhat the author calls the stage it reached.
verbstringThe words the author put on the move, “Qualify”, “Mark false positive”.
isEndbooleanWhether the destination ends the case. case-closed also fires when it does.

A case was closed.

Subscribe tocase-closed

What it hands your flow

PinTypeWhat it is
caseIdstringThe case this event is about.
codestringThe case reference shown to people.
caseTypeCodestringThe case’s own TYPE code, distinct from kind (the alert/report vocabulary): lets a flow narrow to one vertical’s cases directly. ” for a case no published type claimed.

A case was routed to a Reviewer.

Subscribe tocase-assigned

What it hands your flow

PinTypeWhat it is
caseIdstringThe case this event is about.
codestringThe case reference shown to people.
caseTypeCodestringThe case’s own TYPE code, distinct from kind (the alert/report vocabulary): lets a flow narrow to one vertical’s cases directly. ” for a case no published type claimed.
assigneeUserIdstringReference to the Reviewer the case was assigned to. Resolve for detail; never a name here.

A Reviewer recorded an Outcome, ending the Review and sending the Case for approval.

Subscribe tocase-outcome-selected
Narrow it byoutcome, so a flow reacts to one kind rather than all of them

What it hands your flow

PinTypeWhat it is
caseIdstringThe case this event is about.
codestringThe case reference shown to people.
caseTypeCodestringThe case’s own TYPE code, distinct from kind (the alert/report vocabulary): lets a flow narrow to one vertical’s cases directly. ” for a case no published type claimed.
outcomestringThe Outcome’s meaning code, as recorded, not the tenant-authored label shown on screen.

An email arrived at a trusted Inbox and passed the sender-alignment check.

Subscribe toemail-received
Narrow it byinboxCode, so a flow reacts to one kind rather than all of them
Also configured onthe Inbox that received it

What it hands your flow

PinTypeWhat it is
inboxIdstringThe Inbox this message was received by.
inboxCodestringThe Inbox reference shown to people.
fromDomainstringThe message’s From domain, as verified by DKIM alignment.
receivedAtstringISO instant the ingest processed the message.
messageRefstringReference to the raw message on the ingest drive. Resolve for content; never a copy here.

A row was added to one of the tenant’s registers.

Subscribe toregister-row-created
Narrow it byregisterCode, so a flow reacts to one kind rather than all of them

What it hands your flow

PinTypeWhat it is
registerIdstringThe register this row belongs to.
registerCodestringThe register’s own code, the name a flow, a case slot or a template refers to it by. It never changes, even when the register is renamed.
rowKeystringWhich row. Pass it to “Look up a register row” to read the values this register allows to travel.

A row in one of the tenant’s registers was corrected.

Subscribe toregister-row-updated
Narrow it byregisterCode, so a flow reacts to one kind rather than all of them

What it hands your flow

PinTypeWhat it is
registerIdstringThe register this row belongs to.
registerCodestringThe register’s own code, the name a flow, a case slot or a template refers to it by. It never changes, even when the register is renamed.
rowKeystringWhich row. Pass it to “Look up a register row” to read the values this register allows to travel.
changedColumnsstringWhich columns changed, by key, comma separated. For reading on the feed, narrow on the register, then read the row for what it says now.

A row was destroyed, along with its change history. Anything pointing at it now points at nothing.

Subscribe toregister-row-destroyed
Narrow it byregisterCode, so a flow reacts to one kind rather than all of them

What it hands your flow

PinTypeWhat it is
registerIdstringThe register this row belongs to.
registerCodestringThe register’s own code, the name a flow, a case slot or a template refers to it by. It never changes, even when the register is renamed.
rowKeystringWhich row. Pass it to “Look up a register row” to read the values this register allows to travel.

A watched date on a register row has come due, or is within its declared notice period.

Subscribe toregister-row-due
Narrow it byregisterCode, so a flow reacts to one kind rather than all of them

What it hands your flow

PinTypeWhat it is
registerIdstringThe register this row belongs to.
registerCodestringThe register’s own code, the name a flow, a case slot or a template refers to it by. It never changes, even when the register is renamed.
rowKeystringWhich row. Pass it to “Look up a register row” to read the values this register allows to travel.
columnKeystringWhich watched date came due, by column key.
dueOnstringThe date that came due, as the row records it.