docs.vin

disposition

The disposition noun — identity, lifecycle, events, and every capability as an anchored section: 1 capability, 0 live, 1 sandbox, 0 declared.

disposition is one of the estate's 317 automotive nouns — a job a car needs done. It carries 1 capability: 0 live, 1 sandbox, 0 declared · doors aggregator.vin.

Identity

Noundisposition
PillarServices (facets: 1 services)
Capabilities1 — 0 live · 1 sandbox · 0 declared
EntitiesInventoryItem
Doorsaggregator.vin
SDKVin.disposition.* from apis.vin
Address/catalog/disposition#{action} — the anchor IS the wire name minus disposition.

More actions

channelRank

disposition.channelRank · GET /dispositions/channel-rank · gate none · sandbox · answers DispositionChannelRank@1

No input — this capability takes no request body.

Dooraggregator.vin serves this noun on its two routes: / (the landing) · /1GKS2DRL6SR208085 (the VIN lens).

Try it — sandbox: every call answers a deterministic, provenance-labeled simulated payload ({ environment, simulated } in the body). Force any documented outcome with the magic triggers. Going live is a connect, never a ballot: submit the credential at integrates.vin (dealer systems) or connects.vin (consumer accounts) — submissions enter the activation queue and rank live rollout.

the SDK — disposition.channelRank
import { disposition } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await disposition.channelRank()
GET /dispositions/channel-rank
curl 'https://apis.vin/dispositions/channel-rank'

Receipt — the sandbox wire answered the request above with this exact body at build time. Captured by the receipts runner (timestamped, provenance in the payload), never authored; it re-executes only when this descriptor changes.

receipt · executed 2026-08-16T14:50:09.761Z · HTTP 200
{
  "type": "OK",
  "answers": "DispositionChannelRank@1",
  "value": {
    "vin": "vin-ad6abd2a",
    "rooftopId": "rooftop_46c48953",
    "stockNumber": "stockNumber-67f38cb0",
    "status": "option-1"
  },
  "evidence": {
    "vin": "vin-ad6abd2a",
    "rooftopId": "rooftop_46c48953",
    "stockNumber": "stockNumber-67f38cb0",
    "status": "option-1"
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "disposition-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Data model

The record shape behind this noun — one entity, each property an evidence field. See the whole estate model on the data model page.

InventoryItem


Generated from the catalog. Every capability, answer, gate, and entity on this page is a rendered descriptor — it cannot drift from the wire.