Products
Replace product media
Replaces the media of the Product and its Variants at once.
PUT/v1/products/{productId}/media
Coming soon
This route is not in the API yet. This page shows what it will do. Fields, examples and the playground arrive when it ships.
Replaces the whole set: the Product media (product) and the media of each Variant (variants[].media). A Variant missing from the list ends up with no media. This is the only route that writes media: create and update of Product and Variant do not accept media.
Every assetId must be a product_media Asset, ready, from the same account and the same seller as the Product. An Asset from another seller returns 400: copy it first with Copy media. An Asset not yet validated returns 409. The route only writes to the local base and nothing is published: to take the change to the listings, use Propagate changes.