Skip to main content
POST
Update Product
Partially updates the product by field; omitted fields remain unchanged. Updating an active product creates a new version and returns the new version ID; changing status is not supported (use Change Product Status instead). features is replaced as a whole: existing features not included are deleted and removed from all prices under this product; when omitted, features remain unchanged. merchant_product_id cannot be cleared, and changes are not synced to prices already created. All features cannot be cleared via this API; feature ids must not repeat within one request.

Authorizations

Authorization
string
header
required

Bearer API Key authentication. Format: Authorization: Bearer {your_api_key}

Headers

Request-Id
string
default:008e3967-a1b5-48bb-be14-d5bff5092e61
required

The unique identifier of the request

Path Parameters

product_id
string
required

Subotiz platform product ID

Body

application/json

Update product request (partial update by field: omitted fields remain unchanged)

product_id
string
required

Subotiz platform product ID

product_name
string

Product name; must not be empty when provided

category_id
string

Product category ID

image_url
string

Product image URL; must not be empty when provided

merchant_product_id
string

Merchant-side product ID, unique within the merchant; empty string is not allowed (clearing it via this API is not supported). Changes are not synced to prices already created

description
string

Product description

features
object[]

Product features list, replaced as a whole:

  • When provided, existing features not included are deleted and removed from all prices under this product
  • When omitted (or an empty list is passed), features remain unchanged, so all features cannot be cleared via this API
  • To keep an existing feature, include its id; entries without id are treated as new; ids must not repeat within one request
quantity_unit
string

Quantity unit name (product-level); empty string resets it to the default "unit"

Response

200 - application/json

OK

Update product response

code
string

error code

message
string

error message

data
object

Update product response