Skip to main content
Each page below documents a single product discovery operation — request, parameters, response shape, and errors. Discovery is the buyer-side loop for finding inventory across sales agents: you run a discovery to open a session, browse and refine the cached results, then build a selection by adding products or applying a seller proposal. A session is a long-lived workspace identified by discoveryId. For the conceptual model — sessions, refinement, proposals, and storefronts — see the Product Discovery guide.

​
Discover

Discover products

POST /discovery/discover-products — run discovery and open a session

Browse products

GET /discovery/:id/discover-products — page through cached results

​
Build a selection

Get products

GET /discovery/:id/products — list the selected products

Add products

POST /discovery/:id/products — add products to the selection

Remove products

DELETE /discovery/:id/products — drop products from the selection

Apply proposal

POST /discovery/:id/apply-proposal — accept a seller’s full allocation