product_set_images
Destructive
Replace product images by uploading local files. First file becomes main image, remaining files become gallery. Requires force=true to overwrite existing images.
Instructions
Replace a product's images. files is a list of absolute paths to local image files (jpg, jpeg, png, webp, gif). First file becomes the main image (image_id); rest are gallery images. Runs Voog's 3-step asset upload protocol per file (POST /assets → PUT upload_url → PUT confirm), then PUTs {image_id, assets:[{id:n}]} to /products/{id}. Refuses to replace existing images unless force=true. If any single upload fails, the product is NOT updated — successful uploads are surfaced in uploaded for manual re-linking.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site | Yes | Site name from voog_list_sites | |
| product_id | Yes | Voog ecommerce product id | |
| files | Yes | Absolute paths to local image files. First is the main image, rest are gallery. | |
| force | No | Required to replace existing images. Defensive opt-in like page_delete — even with the destructiveHint annotation, the server refuses without force=true. |