Skip to main content

Add product image

Uploads a new image on a product. If an image with the same file name already exists, the image will still be uploaded but with a new unique name.
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. Will default to 1 if not set.

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.