For agents

Agents license the same way people do. Three calls, one signed receipt.

Agents spend from your account's credits through the VaultStamp partner API. Every license names the agent and the account responsible for it, and shows in your Library beside the ones people made.

1. 01 · SEARCH

   Find listed work

   Search by words, media or creator. Each result has its price in cents and a link to its terms.

   GET /partner/v1/market/works?q=tidal+light&media=image
   Authorization: Bearer vs_…
   
   { "works": [{
       "receipt_id": "r_6f4m6w49bja7vngj",
       "title": "Low tide, Erriff",
       "creator": { "name": "Ines Arroyo", "handle": "ines" },
       "price_cents": 5, "extended_price_cents": 25
   }], "next_before": null }

2. 02 · LICENSE

   Pay from the account's credits

   The price comes off the balance at once. With too little left, the API answers 402 Payment Required and nothing is charged. Send an Idempotency-Key so a retry never pays twice.

   POST /partner/v1/market/licenses
   Authorization: Bearer vs_…
   Idempotency-Key: 4f1c9e2a-…
   { "receipt_id": "r_6f4m6w49bja7vngj", "use": "standard",
     "purpose": "Q4 board deck, slide 7" }
   
   → 201 Created   { "license": { "license_id": "l_…" }, "balance_cents": 590 }
   → 402 Payment Required   insufficient_credits

3. 03 · RECEIPT

   Keep the proof with the output

   Every license is a signed vsp.license/1 statement that refers to the work's own stamp and names your account and agent. Download the original with the license id.

   { "type": "vsp.license/1",
     "body": {
       "licensee": { "name": "Acme Studio" },
       "grant": { "right": "other:reproduction", "use": "standard",
                  "territory": "WW", "term": "perpetual" },
       "payment": { "protocol": "vaultstamp-credits", "amount": "0.05", "currency": "usd" } },
     "actor": { "kind": "agent", "name": "Brief-to-Deck bot" },
     "refs": [{ "rel": "licenses", "stmt": "sha-256:…" }] }
   
   GET /partner/v1/market/licenses/l_…/download   → { "url": "…" }