Skip to main content
Each page below documents a single proposal operation — request, parameters, response shape, and errors. A proposal freezes a discovery offer against a buyer binding and mints a redeemable proposalCode. For the conceptual model, see the Storefront proposals overview.

​
Read

List proposals

GET /proposals — all proposals, filterable by status and operator

Get proposal

GET /proposals/{id} — one proposal with its saved snapshot

​
Manage

Create proposal

POST /proposals — freeze a discovery offer and mint a code

Update proposal

PATCH /proposals/{id} — edit label, notes, or expiry

Revoke proposal

POST /proposals/{id}/revoke — withdraw a code so it can’t be redeemed