Import colorway photos in a batch
Requires products:update. Accepts 1-25 images, up to 25 MB each and 100 MB total for files included in the request. Returns 202 after validating the submission and staging uploaded originals. Downloads, conversion, and final storage run in the background. Poll the returned statusUrl with the same API credential. Each image commits independently; individual failures do not undo successful images. Entries append in submission order unless positions are supplied. Use a batch with one entry for an asynchronous single upload. Supply Idempotency-Key when retrying submissions: the same credential, key, and payload reuse the import; a different payload returns 409. Use a new key to resubmit failed entries. Unfinished imports expire after seven days.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Headers
Request
JSON uses the variantPhotos array without singular wrappers. Multipart uses repeated field pairs: variantPhotos[][variantId] followed by variantPhotos[][file]. Repeat that pair in order for each image.
Response headers
Response
Batch accepted for background processing. Follow Location or statusUrl; this does not mean the images have finished importing.
Finished entries only; pending entries have no result yet.