Leave Promotion
POST/promotions/:promotionId/leave
Take listings out of a promotion. A listing not in it is answered NotApplied and nothing is sent for it. The write is planned again the way its preview was, then sent. One outcome per listing is recorded before anything is sent, each is settled by the marketplace's answer, and the listings are read back. A listing the checks refuse is not sent while the others are; when every listing is refused the request is a 400. When the preview lists a step with isRiskOfLoss, send isRiskAcknowledged: true. A second write to the same promotion while one is running is a 409 conflict. Amazon promotions are read-only: a write on one is a 403. 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):
batchId(string, required),promotionId(integer or null, required),steps(array, required),results(array, required),summary(object, required).