docs.vin

photos

The photos noun — identity, lifecycle, events, and every capability as an anchored section: 14 capabilities, 2 live, 12 sandbox, 0 declared.

photos is one of the estate's 317 automotive nouns — a job a car needs done. It carries 14 capabilities: 2 live, 12 sandbox, 0 declared · doors photos.vin.

Identity

Nounphotos
PillarServices (facets: 5 data · 6 services · 3 commerce)
Capabilities14 — 2 live · 12 sandbox · 0 declared
EntitiesListing
Doorsphotos.vin
SDKVin.photos.* from apis.vin
Address/catalog/photos#{action} — the anchor IS the wire name minus photos.

Events

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

Discover & read

get

photos.get · GET /photos/get · gate none · live · answers PhotoSet@1

FieldTypeRequiredNotes
vinstringyes—
kindstringnoone of retail, wholesale, stock, historical
transformobjectno—

Door — photos.vin serves this noun on its two routes: / (the landing) · /3C6TR5EJ7NG141465 (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 — photos.get
import { photos } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await photos.get({"vin":"3C6TR5EJ7NG141465"})
GET /photos/get
curl 'https://apis.vin/photos/get?vin=3C6TR5EJ7NG141465'

compare

photos.compare · GET /photos/compare · gate key · sandbox · answers PhotosCompare@1

FieldTypeRequiredNotes
vinstringno—

Door — photos.vin serves this noun on its two routes: / (the landing) · /3C6TR5EJ7NG141465 (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 — photos.compare
import { photos } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await photos.compare({"vin":"3C6TR5EJ7NG141465"})
GET /photos/compare
curl 'https://apis.vin/photos/compare?vin=3C6TR5EJ7NG141465'

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:15.543Z · HTTP 200
{
  "type": "OK",
  "answers": "PhotosCompare@1",
  "value": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "comparison": {
      "setId": "PH-799bacf2",
      "grade": "clean",
      "consistent": true,
      "basis": "condition-grade",
      "damageShots": 0
    }
  },
  "evidence": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "comparison": {
      "setId": "PH-799bacf2",
      "grade": "clean",
      "consistent": true,
      "basis": "condition-grade",
      "damageShots": 0
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "showroom-polish-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

classify

photos.classify · GET /photos/classify · gate none · sandbox · answers PhotosClassify@1

FieldTypeRequiredNotes
vinstringno—

Door — photos.vin serves this noun on its two routes: / (the landing) · /3C6TR5EJ7NG141465 (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 — photos.classify
import { photos } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await photos.classify({"vin":"3C6TR5EJ7NG141465"})
GET /photos/classify
curl 'https://apis.vin/photos/classify?vin=3C6TR5EJ7NG141465'

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:15.540Z · HTTP 200
{
  "type": "OK",
  "answers": "PhotosClassify@1",
  "value": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "classification": {
      "setId": "PH-799bacf2",
      "byAngle": {
        "exterior": 8,
        "interior": 4,
        "damage": 0
      }
    }
  },
  "evidence": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "classification": {
      "setId": "PH-799bacf2",
      "byAngle": {
        "exterior": 8,
        "interior": 4,
        "damage": 0
      }
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "showroom-polish-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

metadataRead

photos.metadataRead · GET /photos/metadata-read · gate none · live · answers PhotosMetadataRead@1

FieldTypeRequiredNotes
vinstringno—

Door — photos.vin serves this noun on its two routes: / (the landing) · /3C6TR5EJ7NG141465 (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 — photos.metadataRead
import { photos } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await photos.metadataRead({"vin":"3C6TR5EJ7NG141465"})
GET /photos/metadata-read
curl 'https://apis.vin/photos/metadata-read?vin=3C6TR5EJ7NG141465'

damageDetect

photos.damageDetect · GET /photos/damage-detect · gate none · sandbox · answers PhotosDamageDetect@1

FieldTypeRequiredNotes
vinstringno—

Door — photos.vin serves this noun on its two routes: / (the landing) · /3C6TR5EJ7NG141465 (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 — photos.damageDetect
import { photos } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await photos.damageDetect({"vin":"3C6TR5EJ7NG141465"})
GET /photos/damage-detect
curl 'https://apis.vin/photos/damage-detect?vin=3C6TR5EJ7NG141465'

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:15.543Z · HTTP 200
{
  "type": "OK",
  "answers": "PhotosDamageDetect@1",
  "value": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "damage": {
      "found": false,
      "count": 0,
      "items": []
    }
  },
  "evidence": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "damage": {
      "found": false,
      "count": 0,
      "items": []
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "showroom-polish-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Apply & book

order

photos.order · POST /photos/order · gate offer · sandbox · answers PhotosOrder@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 — photos.vin serves this noun on its two routes: / (the landing) · /3C6TR5EJ7NG141465 (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 — Order.placed@1 · Photos.ordered@1 · ServiceOrder.settled@1.

the SDK — photos.order
import { photos } from 'apis.vin'

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

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:15.544Z · HTTP 200
{
  "type": "OK",
  "answers": "PhotosOrder@1",
  "value": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "order": {
      "id": "ORD-2644baba",
      "setId": "PH-799bacf2",
      "status": "placed",
      "amountCents": 14900,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "order": {
      "id": "ORD-2644baba",
      "setId": "PH-799bacf2",
      "status": "placed",
      "amountCents": 14900,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "showroom-polish-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

subscribe

photos.subscribe · POST /photos/subscribe · gate offer · sandbox · answers PhotosSubscribe@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 — photos.vin serves this noun on its two routes: / (the landing) · /3C6TR5EJ7NG141465 (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 — Photos.subscribed@1.

the SDK — photos.subscribe
import { photos } from 'apis.vin'

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

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:15.552Z · HTTP 200
{
  "type": "OK",
  "answers": "PhotosSubscribe@1",
  "value": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "subscription": {
      "id": "PS-d72dd155",
      "plan": "photo-media",
      "amountCents": 24900,
      "currency": "USD",
      "status": "active"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "subscription": {
      "id": "PS-d72dd155",
      "plan": "photo-media",
      "amountCents": 24900,
      "currency": "USD",
      "status": "active"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "showroom-polish-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Pay & settle

pay

photos.pay · POST /photos/pay · gate offer · sandbox · answers PhotosPay@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 — photos.vin serves this noun on its two routes: / (the landing) · /3C6TR5EJ7NG141465 (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 — Photos.charged@1 · ServiceOrder.settled@1.

the SDK — photos.pay
import { photos } from 'apis.vin'

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

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:15.544Z · HTTP 200
{
  "type": "OK",
  "answers": "PhotosPay@1",
  "value": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "payment": {
      "id": "PAY-ef7e39a4",
      "status": "settled",
      "amountCents": 14900,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "evidence": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "payment": {
      "id": "PAY-ef7e39a4",
      "status": "settled",
      "amountCents": 14900,
      "currency": "USD"
    },
    "payer": {
      "name": "Ava Good",
      "castRow": "super-prime",
      "creditTier": "super-prime"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "showroom-polish-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

capture

photos.capture · POST /photos/capture · gate offer · sandbox · answers PhotosCapture@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 — photos.vin serves this noun on its two routes: / (the landing) · /3C6TR5EJ7NG141465 (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 — Photos.captured@1.

the SDK — photos.capture
import { photos } from 'apis.vin'

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

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:15.540Z · HTTP 200
{
  "type": "OK",
  "answers": "PhotosCapture@1",
  "value": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "set": {
      "id": "PH-799bacf2",
      "status": "captured",
      "shots": 12,
      "plan": {
        "exterior": 8,
        "interior": 4,
        "damage": 0
      },
      "grade": "clean"
    }
  },
  "evidence": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "set": {
      "id": "PH-799bacf2",
      "status": "captured",
      "shots": 12,
      "plan": {
        "exterior": 8,
        "interior": 4,
        "damage": 0
      },
      "grade": "clean"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "showroom-polish-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

Fulfill & operate

publish

photos.publish · POST /photos/publish · gate offer · sandbox · answers PhotosPublish@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 — photos.vin serves this noun on its two routes: / (the landing) · /3C6TR5EJ7NG141465 (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 — Photos.published@1.

the SDK — photos.publish
import { photos } from 'apis.vin'

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

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:15.544Z · HTTP 200
{
  "type": "OK",
  "answers": "PhotosPublish@1",
  "value": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "publication": {
      "status": "published-to-listing",
      "setId": "PH-799bacf2",
      "listingId": "LST-ca301238",
      "position": "Draft"
    }
  },
  "evidence": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "publication": {
      "status": "published-to-listing",
      "setId": "PH-799bacf2",
      "listingId": "LST-ca301238",
      "position": "Draft"
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "showroom-polish-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

annotate

photos.annotate · POST /photos/annotate · gate offer · sandbox · answers PhotosAnnotate@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 — photos.vin serves this noun on its two routes: / (the landing) · /3C6TR5EJ7NG141465 (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 — Photos.annotated@1.

the SDK — photos.annotate
import { photos } from 'apis.vin'

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

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:15.539Z · HTTP 200
{
  "type": "OK",
  "answers": "PhotosAnnotate@1",
  "value": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "annotation": {
      "status": "no-damage-to-annotate",
      "annotations": 0
    }
  },
  "evidence": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "annotation": {
      "status": "no-damage-to-annotate",
      "annotations": 0
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "showroom-polish-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

More actions

backgroundSwap

photos.backgroundSwap · POST /photos/background-swap · gate offer · sandbox · answers PhotosBackgroundSwap@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 — photos.vin serves this noun on its two routes: / (the landing) · /3C6TR5EJ7NG141465 (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 — PhotoMedia.backgroundSwapped@1.

the SDK — photos.backgroundSwap
import { photos } from 'apis.vin'

// the gate law is in the type system: Answer<T> = Ok | Empty | Blocked | Offer
const answer = await photos.backgroundSwap({"vin":"3C6TR5EJ7NG141465"})
POST /photos/background-swap
curl -X POST https://apis.vin/photos/background-swap \
  -H 'content-type: application/json' \
  -d '{"vin":"3C6TR5EJ7NG141465"}'

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:15.539Z · HTTP 200
{
  "type": "OK",
  "answers": "PhotosBackgroundSwap@1",
  "value": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "swap": {
      "setId": "PH-799bacf2",
      "status": "swapped",
      "background": "studio-neutral",
      "shots": 8
    }
  },
  "evidence": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "swap": {
      "setId": "PH-799bacf2",
      "status": "swapped",
      "background": "studio-neutral",
      "shots": 8
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "showroom-polish-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

enhance

photos.enhance · POST /photos/enhance · gate offer · sandbox · answers PhotosEnhance@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 — photos.vin serves this noun on its two routes: / (the landing) · /3C6TR5EJ7NG141465 (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 — Photos.enhanced@1.

the SDK — photos.enhance
import { photos } from 'apis.vin'

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

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:15.544Z · HTTP 200
{
  "type": "OK",
  "answers": "PhotosEnhance@1",
  "value": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "enhancement": {
      "setId": "PH-799bacf2",
      "status": "enhanced",
      "shots": 12
    }
  },
  "evidence": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "enhancement": {
      "setId": "PH-799bacf2",
      "status": "enhanced",
      "shots": 12
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "showroom-polish-sandbox"
  },
  "events": [],
  "meter": {
    "charged": "0.00",
    "posted": false
  }
}

spin360

photos.spin360 · POST /photos/spin360 · gate offer · sandbox · answers PhotosSpin360@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 — photos.vin serves this noun on its two routes: / (the landing) · /3C6TR5EJ7NG141465 (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 — PhotoMedia.spin360Rendered@1.

the SDK — photos.spin360
import { photos } from 'apis.vin'

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

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:15.548Z · HTTP 200
{
  "type": "OK",
  "answers": "PhotosSpin360@1",
  "value": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "spin": {
      "id": "SPIN-73d0782a",
      "status": "captured",
      "frames": 36
    }
  },
  "evidence": {
    "vin": "3C6TR5EJ7NG141465",
    "noun": "photos",
    "asOf": "2026-08-10",
    "spin": {
      "id": "SPIN-73d0782a",
      "status": "captured",
      "frames": 36
    }
  },
  "provenance": {
    "simulated": true,
    "environment": "sandbox",
    "source": "showroom-polish-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.

Listing

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

photoMedia

The photoMedia noun — identity, lifecycle, events, and every capability as an anchored section: 14 capabilities, 2 live, 12 sandbox, 0 declared.

plate

The plate noun — identity, lifecycle, events, and every capability as an anchored section: 11 capabilities, 3 live, 8 sandbox, 0 declared.

On this page

Identity
Events
Discover & read
get
compare
classify
metadataRead
damageDetect
Apply & book
order
subscribe
Pay & settle
pay
capture
Fulfill & operate
publish
annotate
More actions
backgroundSwap
enhance
spin360
Data model
Listing