Upsert images of a product

POST

https://core.shopimind.com/v1/products/{product_id}/images

Creates or updates up to 50 images for the specified product. Each image is matched on image_id. Any product_id value sent in the body is ignored — the path parameter always takes precedence. URLs must be public HTTPS resources of type image/jpeg, image/png, or image/webp. Use bulkCreateProductImages if you need to mix multiple parents. Processing is asynchronous.

Parameters

Header Parameters

spm-api-key*

[Authentication] Required API key.

Type

string

Required

Pattern

"^[a-zA-Z0-9-]{20,64}$"

Path Parameters

product_id*

Identifier of the parent product.

Type

string

Required

Request Body

application/json

[

  

{

  

  

"image_id": "img_001",

  

  

"lang": "en",

  

  

"variation_id": 1,

  

  

"url": "https://www.example.com/image.jpg",

  

  

"is_default": true

  

}

]

Responses

Objects have been sent to the processing queue. Partially invalid objects are rejected and returned in rejected_items.

Content-Type

application/json

{

  

"statusCode": 200,

  

"sent_count": 5,

  

"rejected_count": 0,

  

"rejected_items": [

  

]

}

POST

https://core.shopimind.com/v1/products/{product_id}/images

Playground

Headers

spm-api-key*

Variables

Key

Value

product_id*

Body

Samples

Upsert images of a product Creates or updates up to 50 images for the specified product. Each image is matched on image_id. Any product_id value sent in the body is ignored — the path parameter always takes precedence. URLs must be public HTTPS resources of type image/jpeg, image/png, or image/webp. Use bulkCreateProductImages if you need to mix multiple parents. Processing is asynchronous. POST /v1/products/{product_id}/images createProductImages Products spm-api-key [Authentication] Required API key. product_id Identifier of the parent product. Objects have been sent to the processing queue. Partially invalid objects are rejected and returned in rejected_items. All objects are invalid, or the request body is not an array, or the array exceeds the maximum allowed size Server error - Internal processing failure