Edit Promotion
POST/promotions/:promotionId/edit
Change one of the brand's own promotions: its end, budget, terms or listings, as editableFields allows. A marketplace programme cannot be edited. 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),budget(number or null),endsAt(string or null),terms(object),addListings(array),removeListings(array). - 200 response (application/json):
batchId(string, required),promotionId(integer or null, required),steps(array, required),results(array, required),summary(object, required).