Skip to main content

Add/update product image

Creates or updates an image on a product. If an image with the same file already exists it will be replaced.
The image is included in the body of the request as binary data.

Path Parameters
productId string REQUIRED

The id of the product to update.

imageName string REQUIRED

The file name of the image that is uploaded.

Query Parameters
position int32

The relative position of the image in the list of images for the product.
For new images this will default to 1 if not set. Leave as null to not change the position on an existing image.

isPrimaryImage boolean

Specifies whether this image is the primary image on the product. Will not remove the image as primary image if set to false.

productIdType int32

Possible values: [0, 1, 2, 3]

The type of product id supplied.
0 = Internal. Internal product id set by Geins.
Eg: 10001.
1 = ArticleNumber. Article number set by customer.
Eg: ABC123.
2 = MarketPrefixedInternal. Internal product id set by Geins, prefixed with market.
Eg: SE10001.
3 = MarketPrefixedArticleNumber. Article number set by customer, prefixed with market.
Eg: SEABC123.

Request Body REQUIRED

The binary data for the image to be uploaded.

string
Responses
200

Details of the uploaded image.

Schema OPTIONAL
Resource object OPTIONAL
FileName string OPTIONAL
Message string OPTIONAL

A status message for the action taken.

Details string[] OPTIONAL

Any validation messages for the data on the current action.

400

Bad request.

Schema OPTIONAL
Message string OPTIONAL

A status message for the action taken.

Details string[] OPTIONAL

Any validation messages for the data on the current action.

404

Not found.

Schema OPTIONAL
Message string OPTIONAL

A status message for the action taken.

Details string[] OPTIONAL

Any validation messages for the data on the current action.

500

Internal server error.

Schema OPTIONAL
Message string OPTIONAL

A status message for the action taken.

Details string[] OPTIONAL

Any validation messages for the data on the current action.