Skip to main content
POST
Observe a delivery

Authorizations

Authorization
string
header
required

API key sent as Authorization: Bearer <api-key>.

Body

application/json
rightId
string
required

The ACTIVE right being exercised (prefixed rgh_).

spatialAnchorId
string
required
Minimum string length: 1
dwellMs
number
required

Milliseconds of dwell on the surface (non-negative).

Required range: x >= 0
spatialPlacementId
string | null

Optional placement within the anchor.

correlationId
string | null

Optional correlation id for upstream tracing.

telemetry
object

Optional substrate-specific telemetry passed to the constraint gate and, where consented, to metering. Accepts the full substrate signal set — DOOH-era, spatial AR/VR (presence, placement, consent), satellite/space-delivered, and screen/video/app signals. Canonical shape: DeliveryTelemetry in packages/sandbox-core/src/types.ts. Known fields below; additional fields are accepted.

Response

The signed receipt payload and the substrate it landed on.

ok
boolean
required
data
object
required

Route-specific payload. Operation responses refine this.

contractVersion
string
required
Allowed value: "v1.0"