Skip to main content

Add a picture to a catalogue item

POST 
/api/catalog/items/:catalogItem/media

PNG, JPEG or WebP, up to 4 MB and 4000 px; re-encoded server-side to strip metadata. The first product-level picture becomes the primary one. stock_item_id attaches the picture to one variant.

Instead of image, asset_id names a media-library image (doc 60 §7): the server copies it to the public catalogue disk through the same rules and sanitiser — nothing is uploaded again.

Request​

Responses​

Stored.