Skip to content

Flow

A Flow is an ordered path through an App’s Dashboards that takes one Persona from first run to an Offer’s activation Event.

Properties

PropertyTypeRequiredDescription
personaPersonarequiredThe Persona it guides; its Role decides which Verbs each step offers.
offerOfferrequiredThe Offer whose activation Event ends the Flow; time to value reads from first step to that Event.
stepslist of DashboardrequiredThe Dashboards in order, first run first, each ending in the Verb that opens the next.

Object

JSON
{
  "$id": "https://api.sb/petpantry.shop/flows/flow_1",
  "$type": "Flow",
  "persona": "persona_1",
  "offer": "offer_1",
  "steps": [
    "dashboard_1"
  ]
}

Relationships

  • A Flow has one App: the Flows an App runs on first sign-in, one per Persona and Offer, each ending at the activation Event. app, inverse guides.

Verbs

  1. createCreates a Flow.
    POST /{namespace}/flowsdoFlow.created
  2. getReturns one Flow by id.
    GET /{namespace}/flows/{id}readNo Event
  3. listReturns Flows, newest first, one page at a time.
    GET /{namespace}/flowsreadNo Event
  4. updateChanges the given properties of a Flow.
    PATCH /{namespace}/flows/{id}doFlow.updated
  5. deleteDeletes a Flow; its history is kept.
    DELETE /{namespace}/flows/{id}doFlow.deleted

Permissions

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

Operationowneradminmemberviewer
Flow.createYesYesYesNo
Flow.getYesYesYesYes
Flow.listYesYesYesYes
Flow.updateYesYesYesNo
Flow.deleteYesYesYesNo

Call it

Text
Add a flow to Kiln Bakery with a persona and an offer and a dashboard.

Example

The buyer Flow on stitchly.co has three steps: describe a garment, pick a tailor, pay for the first Order. It ends at Customer.activated, and time to value is measured across those three steps.