docs.vin

buildSheet

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

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

Identity

NounbuildSheet
PillarData (facets: 4 data · 1 services)
Capabilities5 — 4 live · 1 sandbox · 0 declared
EntitiesVehicle
Doorsaggregator.vin
SDKVin.buildSheet.* from apis.vin
Address/catalog/buildSheet#{action} — the anchor IS the wire name minus buildSheet.

Events

The vocabulary this noun can append to the record — 1 past-tense, versioned event type, each linked to the capability that emits it:

Discover & read

read

buildSheet.read · GET /build-sheets/read · gate none · live · answers BuildSheetRead@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1FTFW1RG9MFC89591 (the VIN lens).

Try it — live: answers on the wire today. A sandbox key still selects the deterministic simulated mode — drive the full outcome range with the magic triggers.

the SDK — buildSheet.read
import { buildSheet } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await buildSheet.read({"vin":"1FTFW1RG9MFC89591"})
GET /build-sheets/read
curl 'https://apis.vin/build-sheets/read?vin=1FTFW1RG9MFC89591'

decode

buildSheet.decode · GET /build-sheets/decode · gate none · live · answers BuildSheetDecode@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1FTFW1RG9MFC89591 (the VIN lens).

Try it — live: answers on the wire today. A sandbox key still selects the deterministic simulated mode — drive the full outcome range with the magic triggers.

the SDK — buildSheet.decode
import { buildSheet } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await buildSheet.decode({"vin":"1FTFW1RG9MFC89591"})
GET /build-sheets/decode
curl 'https://apis.vin/build-sheets/decode?vin=1FTFW1RG9MFC89591'

Fulfill & operate

generate

buildSheet.generate · POST /build-sheets/generate · gate offer · sandbox · answers BuildSheetGenerate@1

FieldTypeRequiredNotes
vinstringno—

The gate is a 402 OFFER — the price and a hard ceiling on the wire, with a durable intent that executes on settlement. Never a wall, never "contact sales". Price: not posted — see /pricing.

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1FTFW1RG9MFC89591 (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.

Emits — BuildSheet.generated@1.

the SDK — buildSheet.generate
import { buildSheet } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await buildSheet.generate({"vin":"1FTFW1RG9MFC89591"})
POST /build-sheets/generate
curl -X POST https://apis.vin/build-sheets/generate \
  -H 'content-type: application/json' \
  -d '{"vin":"1FTFW1RG9MFC89591"}'

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-17T12:42:08.579Z · HTTP 200
{
  "type": "OK",
  "answers": "BuildSheetGenerate@1",
  "value": {
    "vin": "1FTFW1RG9MFC89591",
    "noun": "buildSheet",
    "asOf": "2026-08-10",
    "vehicleId": "VEH-ba376894",
    "year": 2024,
    "bodyStyle": "sedan",
    "drivetrain": "fwd",
    "odometer": 76216,
    "condition": "clean",
    "currentOwnerId": "ID-11f17424",
    "buildSheet": {
      "id": "BSH-d51c348c",
      "sheet": {
        "vehicleId": "VEH-ba376894",
        "vin": "1FTFW1RG9MFC89591",
        "year": 2024,
        "bodyStyle": "sedan",
        "drivetrain": "fwd",
        "fuelSystem": {
          "fuel": "gasoline",
          "tankCapacityGal": "14.8",
          "ratedPressurePsi": 58,
          "injection": "direct"
        },
        "basis": "one-spec-sheet"
      },
      "status": "generated"
    }
  },
  "evidence": {
    "vin": "1FTFW1RG9MFC89591",
    "noun": "buildSheet",
    "asOf": "2026-08-10",
    "vehicleId": "VEH-ba376894",
    "year": 2024,
    "bodyStyle": "sedan",
    "drivetrain": "fwd",
    "odometer": 76216,
    "condition": "clean",
    "currentOwnerId": "ID-11f17424",
    "buildSheet": {
      "id": "BSH-d51c348c",
      "sheet": {
        "vehicleId": "VEH-ba376894",
        "vin": "1FTFW1RG9MFC89591",
        "year": 2024,
        "bodyStyle": "sedan",
        "drivetrain": "fwd",
        "fuelSystem": {
          "fuel": "gasoline",
          "tankCapacityGal": "14.8",
          "ratedPressurePsi": 58,
          "injection": "direct"
        },
        "basis": "one-spec-sheet"
      },
      "status": "generated"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "spec-sheet-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

constraints

buildSheet.constraints · GET /build-sheets/constraints · gate none · live · answers BuildSheetConstraints@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1FTFW1RG9MFC89591 (the VIN lens).

Try it — live: answers on the wire today. A sandbox key still selects the deterministic simulated mode — drive the full outcome range with the magic triggers.

the SDK — buildSheet.constraints
import { buildSheet } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await buildSheet.constraints({"vin":"1FTFW1RG9MFC89591"})
GET /build-sheets/constraints
curl 'https://apis.vin/build-sheets/constraints?vin=1FTFW1RG9MFC89591'

optionContent

buildSheet.optionContent · GET /build-sheets/option-content · gate none · live · answers BuildSheetOptionContent@1

FieldTypeRequiredNotes
vinstringno—

Door — aggregator.vin serves this noun on its two routes: / (the landing) · /1FTFW1RG9MFC89591 (the VIN lens).

Try it — live: answers on the wire today. A sandbox key still selects the deterministic simulated mode — drive the full outcome range with the magic triggers.

the SDK — buildSheet.optionContent
import { buildSheet } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await buildSheet.optionContent({"vin":"1FTFW1RG9MFC89591"})
GET /build-sheets/option-content
curl 'https://apis.vin/build-sheets/option-content?vin=1FTFW1RG9MFC89591'

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.

Vehicle

Modeled

The noun drawn out — its record shape, its lifecycle, and how it is exercised end to end. One diagram, rendered from the estate model.

BuildSheet · Class model

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

beltsHoses

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

campaign

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

On this page

Identity
Events
Discover & read
read
decode
Fulfill & operate
generate
More actions
constraints
optionContent
Data model
Vehicle
Modeled