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.
Case opened
Section titled “Case opened”A case was opened, from a telematics alert or an ingested email.
| Subscribe to | case-opened |
| Narrow it by | kind, so a flow reacts to one kind rather than all of them |
What it hands your flow
| Pin | Type | What it is |
|---|---|---|
caseId | string | The case this event is about. |
code | string | The case reference shown to people. |
caseTypeCode | string | The 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. |
kind | string | What kind of alert opened it. |
channel | string | How it arrived (‘alert’, ‘inbox’, ‘report’), as distinct from what kind it was. |
severity | string | Severity as reported, before any grading. |
vehicleRef | string | Reference to the vehicle. Resolve for detail; never a plate here. |
occurredAt | string | ISO instant the underlying event happened. |
Case severity graded
Section titled “Case severity graded”A severity grade was recorded on a case, by a person or by a flow.
| Subscribe to | case-severity-graded |
| Narrow it by | severity, so a flow reacts to one kind rather than all of them |
What it hands your flow
| Pin | Type | What it is |
|---|---|---|
caseId | string | The case this event is about. |
code | string | The case reference shown to people. |
caseTypeCode | string | The 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. |
kind | string | What kind of alert opened the case. |
severity | string | The grade that was recorded. |
vehicleRef | string | Reference to the vehicle. |
occurredAt | string | ISO instant the underlying event happened. |
Case moved stage
Section titled “Case moved stage”A case moved along its kind’s own process, by the verb its author wrote.
| Subscribe to | case-stage-moved |
| Narrow it by | to, so a flow reacts to one kind rather than all of them |
What it hands your flow
| Pin | Type | What it is |
|---|---|---|
caseId | string | The case this event is about. |
code | string | The case reference shown to people. |
caseTypeCode | string | The 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. |
to | string | The stage the case moved INTO, by its authored id. |
from | string | The stage it left. |
fromLabel | string | What the author calls the stage it left. |
toLabel | string | What the author calls the stage it reached. |
verb | string | The words the author put on the move, “Qualify”, “Mark false positive”. |
isEnd | boolean | Whether the destination ends the case. case-closed also fires when it does. |
Case closed
Section titled “Case closed”A case was closed.
| Subscribe to | case-closed |
What it hands your flow
| Pin | Type | What it is |
|---|---|---|
caseId | string | The case this event is about. |
code | string | The case reference shown to people. |
caseTypeCode | string | The 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. |
Case assigned
Section titled “Case assigned”A case was routed to a Reviewer.
| Subscribe to | case-assigned |
What it hands your flow
| Pin | Type | What it is |
|---|---|---|
caseId | string | The case this event is about. |
code | string | The case reference shown to people. |
caseTypeCode | string | The 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. |
assigneeUserId | string | Reference to the Reviewer the case was assigned to. Resolve for detail; never a name here. |
Case outcome selected
Section titled “Case outcome selected”A Reviewer recorded an Outcome, ending the Review and sending the Case for approval.
| Subscribe to | case-outcome-selected |
| Narrow it by | outcome, so a flow reacts to one kind rather than all of them |
What it hands your flow
| Pin | Type | What it is |
|---|---|---|
caseId | string | The case this event is about. |
code | string | The case reference shown to people. |
caseTypeCode | string | The 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. |
outcome | string | The Outcome’s meaning code, as recorded, not the tenant-authored label shown on screen. |
Email received
Section titled “Email received”An email arrived at a trusted Inbox and passed the sender-alignment check.
| Subscribe to | email-received |
| Narrow it by | inboxCode, so a flow reacts to one kind rather than all of them |
| Also configured on | the Inbox that received it |
What it hands your flow
| Pin | Type | What it is |
|---|---|---|
inboxId | string | The Inbox this message was received by. |
inboxCode | string | The Inbox reference shown to people. |
fromDomain | string | The message’s From domain, as verified by DKIM alignment. |
receivedAt | string | ISO instant the ingest processed the message. |
messageRef | string | Reference to the raw message on the ingest drive. Resolve for content; never a copy here. |
Register row added
Section titled “Register row added”A row was added to one of the tenant’s registers.
| Subscribe to | register-row-created |
| Narrow it by | registerCode, so a flow reacts to one kind rather than all of them |
What it hands your flow
| Pin | Type | What it is |
|---|---|---|
registerId | string | The register this row belongs to. |
registerCode | string | The 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. |
rowKey | string | Which row. Pass it to “Look up a register row” to read the values this register allows to travel. |
Register row changed
Section titled “Register row changed”A row in one of the tenant’s registers was corrected.
| Subscribe to | register-row-updated |
| Narrow it by | registerCode, so a flow reacts to one kind rather than all of them |
What it hands your flow
| Pin | Type | What it is |
|---|---|---|
registerId | string | The register this row belongs to. |
registerCode | string | The 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. |
rowKey | string | Which row. Pass it to “Look up a register row” to read the values this register allows to travel. |
changedColumns | string | Which columns changed, by key, comma separated. For reading on the feed, narrow on the register, then read the row for what it says now. |
Register row destroyed
Section titled “Register row destroyed”A row was destroyed, along with its change history. Anything pointing at it now points at nothing.
| Subscribe to | register-row-destroyed |
| Narrow it by | registerCode, so a flow reacts to one kind rather than all of them |
What it hands your flow
| Pin | Type | What it is |
|---|---|---|
registerId | string | The register this row belongs to. |
registerCode | string | The 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. |
rowKey | string | Which row. Pass it to “Look up a register row” to read the values this register allows to travel. |
Register date due
Section titled “Register date due”A watched date on a register row has come due, or is within its declared notice period.
| Subscribe to | register-row-due |
| Narrow it by | registerCode, so a flow reacts to one kind rather than all of them |
What it hands your flow
| Pin | Type | What it is |
|---|---|---|
registerId | string | The register this row belongs to. |
registerCode | string | The 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. |
rowKey | string | Which row. Pass it to “Look up a register row” to read the values this register allows to travel. |
columnKey | string | Which watched date came due, by column key. |
dueOn | string | The date that came due, as the row records it. |