Skip to main content

Preview Leave Promotion

POST 

/promotions/:promotionId/leave/preview

Check taking listings out of a promotion. A listing not in it is reported unchanged. Nothing is sent to the marketplace: the preview resolves each SKU, reads the caps, checks stock, deadlines and the marketplace's own rules, and prices every listing. A loss or a below-target margin is flagged, never refused. Requires promotions.write.

Request and response fields at a glance
  • Path parameters: promotionId (integer, required).
  • Request body (application/json): brandId (integer, required), listings (array, required), reason (string).
  • 200 response (application/json): action (string, required), promotionId (integer or null, required), steps (array, required), commitment (object, required), listings (array, required), summary (object, required), warnings (array, required).

Request​