Skip to navigation

Update a product

View as Markdown

Changes only the fields sent. categoryIds replaces the product’s categories. Requires products:write.

Authentication

AuthorizationBearer

An API key from the store's admin: חנות > API ומפתחות. Send it as Authorization: Bearer coi_sk_... (or X-Api-Key: coi_sk_...). Never in the URL - ?apikey= is refused with 400.

Path parameters

idintegerRequired

Request

This endpoint expects an object.
namestringOptional<=200 characters
pricedoubleOptional>=0
oldPricedoubleOptional>=0
deliveryPricedoubleOptional>=0
costdoubleOptional>=0
stockdouble or nullOptional>=0

null = not counted.

categoryIdslist of integersOptional

Ids of this store's product categories (see categoryIds on any product). Replaces the product's categories.

skustringOptional<=50 characters
internalSkustringOptional<=50 characters
activebooleanOptionalDefaults to true
urlNamestringOptional<=200 characters

The page address. Made from the name on create when not sent; kept unique among the store's pages.

summarystringOptional
descriptionstringOptional

HTML, up to 250,000 characters. Images must be links, not inlined data:.

brandstringOptional<=100 characters
manufacturerstringOptional<=50 characters
modelstringOptional<=50 characters
gtinstringOptional<=50 characters
vatFreebooleanOptional
showInSearchbooleanOptionalDefaults to true
showInMirrorbooleanOptionalDefaults to true
seoTitlestringOptional<=100 characters
seoDescriptionstringOptional<=200 characters

Response

The updated product.
oktrueOptional
dataobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error