Bulk update product images and videos

PUT https://app.ecwid.com/api/v3/{storeId}/products/{productId}/media

Required access scopes

Your app must have the following access scopes to make this request: update_catalog

Path params

All path params are required.

Param	Type	Description
storeId	number	Ecwid store ID.
productId	number	Internal product ID.

Headers

The Authorization header is required. Request works with any access token, though the public token receives limited data.

Header	Format	Description
Authorization	Bearer secret_ab***cd	Access token of the application.

Request JSON

A JSON object with the following fields:

Field	Type	Description
mainMedia	object mainMedia	Link to the main product image or video. Empty or null value commits no changes.
galleryMedia	array of objects galleryMedia	List of links to product gallery images and videos. If both lists are empty the gallery will be deleted.

mainMedia

Field	Type	Description
videoUrl	imageUrl	Link to the main product video. Overrides current main product image/video. If missing, the main product video will be deleted.
imageUrl	imageUrl	Link to the main product image. Overrides current main product image/video. If missing, the main product image will be deleted.

galleryMedia

Field	Type	Description
videoUrl	imageUrl	Link to the gallery product video. galleryMedia array overrides current gallery of product images and videos. If galleryMedia is missing, all gallery product images and videos will be deleted.
imageUrl	imageUrl	Link to the gallery product image. galleryMedia array overrides current gallery of product images and videos. If galleryMedia is missing, all gallery product images and videos will be deleted.