Skip to content

Exposure

An Exposure is the moment one unit meets the Variant its Flag assigned, logged with every option and its propensity.

Properties

PropertyTypeRequiredDescription
unitstringrequiredWhat was randomized: a Visitor, a Customer, a request, or an agent choice.
optionsjsonrequiredEvery Variant that was possible at that moment.
propensitynumberrequiredThe probability the assigned Variant had, kept for later estimates.
atdatetimerequiredWhen the unit met the Variant.
triggeredbooleanTrue when the unit reached the point the Variant changes.

Object

JSON
{
  "$id": "https://api.sb/patentpad.com/exposures/exposure_1",
  "$type": "Exposure",
  "unit": "Example unit",
  "options": {},
  "propensity": 1,
  "at": "2026-10-22T12:00:00Z",
  "triggered": true
}

Relationships

Verbs

  1. createCreates an Exposure.
    POST /{namespace}/exposuresdoExposure.created
  2. getReturns one Exposure by id.
    GET /{namespace}/exposures/{id}readNo Event
  3. listReturns Exposures, newest first, one page at a time.
    GET /{namespace}/exposuresreadNo Event

An Exposure 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
Exposure.createYesYesYesNo
Exposure.getYesYesYesYes
Exposure.listYesYesYesYes

Call it

Text
Add an exposure to ShiftNote.

Example

A Visitor who scrolls to a tutoring site's pricing table meets its Flag split. One Exposure records both Variants as options, the challenger assigned at a propensity of 0.5.