Visitor · StartupBuilder

Properties

Property	Type	Required	Description
`firstSeenAt`	`datetime`	required	When the first request arrived.

JSON

{
  "$id": "https://api.sb/kilnbakery.com/visitors/visitor_1",
  "$type": "Visitor",
  "firstSeenAt": "2026-10-22T12:00:00Z"
}

A Visitor is identified as one Lead: a Lead, once it gives an address, is tied to every Visitor id it used, one per device. identifiedAs, inverse identifies.
A Visitor starts many Visits: each Visit is one span of a Visitor’s Events on the Startup’s Sites and Apps. starts, inverse startedBy.

createCreates a Visitor.
POST /{namespace}/visitorsdoVisitor.created
getReturns one Visitor by id.
GET /{namespace}/visitors/{id}readNo Event
listReturns Visitors, newest first, one page at a time.
GET /{namespace}/visitorsreadNo Event
updateChanges the given properties of a Visitor.
PATCH /{namespace}/visitors/{id}doVisitor.updated
deleteDeletes a Visitor; its history is kept.
DELETE /{namespace}/visitors/{id}doVisitor.deleted
forgetForget masks a person’s captured data across every Event and Recording and suppresses further capture, keeping the records.
POST /{namespace}/visitors/{visitor}/forgetdoVisitor.forgotten
identifyIdentify joins a Visitor to the Contact it turns out to be, so earlier Visits count toward that person.
POST /{namespace}/visitors/{visitor}/identifydoVisitor.identified
mergeMerge joins two Visitor ids that belong to one person and keeps both as aliases.
POST /{namespace}/visitors/{visitor}/mergedoVisitor.merged

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

Operation	`owner`	`admin`	`member`	`viewer`
`Visitor.create`	Yes	Yes	Yes	No
`Visitor.get`	Yes	Yes	Yes	Yes
`Visitor.list`	Yes	Yes	Yes	Yes
`Visitor.update`	Yes	Yes	Yes	No
`Visitor.delete`	Yes	Yes	Yes	No
`Visitor.forget`	Yes	No	No	No
`Visitor.identify`	Yes	Yes	Yes	No
`Visitor.merge`	Yes	Yes	Yes	No

Text

Identify the latest visitor with a contact.

Someone reads the pricing Page of a meal-planning App without signing in. The Visitor is known only as v_8f2c, an id no sibling Startup sees.