Call GET /product-projections/{id}?staged=true to inspect the staged version of the product including pending price changes before they are published
Apply price changes to the staged version via product update actions (addPrice, changePrice) without publishing; confirm changes are visible at staged=true but not staged=false
Use the Query endpoint (GET /product-projections/search?staged=true&filter=...) to verify a batch of staged products meet your pricing criteria before bulk publishing
Publish each product using the POST /products/{id} update action publish to move staged changes to current; for bulk rollout, queue publishes and respect rate limits
After publishing, re-query staged=false projections or use a search re-index trigger to confirm the current projection reflects the new prices in search results
Known gotchas
Products have independent staged and current projections; a GET /products/{id} returns both in the same response body under masterData.staged and masterData.current — do not confuse the two when reading prices
The search index for /product-projections/search lags behind direct API reads by up to a minute after publishing; use direct projection reads for immediate consistency checks after a publish action
Unpublished (hasStagedChanges=true, published=false) products are not returned in /product-projections/search by default; pass staged=true to the search endpoint to include them
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp