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.

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.

Last updated

Was this helpful?