Skip to main content
PATCH
/
api
/
v1
/
catalog
/
products
/
{sku}
Patch Product
curl --request PATCH \
  --url https://api.example.com/api/v1/catalog/products/{sku} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "category_path": "<string>",
  "brand": "<string>",
  "description": "<string>",
  "ingredients": "<string>",
  "country": "<string>",
  "unit": "<string>",
  "quantity_step": 123,
  "min_quantity": 123,
  "weight": 123,
  "volume": 123,
  "image_url": "<string>",
  "attributes": {},
  "barcode": "<string>",
  "is_active": true
}
'
{
  "sku": "<string>",
  "updated_fields": [
    "<string>"
  ],
  "re_embedded": true
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

sku
string
required

Body

application/json

Partial update model. All fields are optional.

name
string | null

Product display name

category_path
string | null

Category hierarchy, e.g. "Dairy > Milk"

brand
string | null

Product brand name

description
string | null

Product description for search and AI context

ingredients
string | null

Ingredients list (plain text)

country
string | null

Country of origin

unit
string | null

Unit of measurement: "pcs", "kg", "l", "g", "ml"

quantity_step
number | null

Minimum increment for quantity selector (e.g. 0.1 for products sold by weight)

min_quantity
number | null

Minimum order quantity (e.g. 0.2 for 200g minimum)

weight
number | null

Product weight in grams (for packaged goods)

volume
number | null

Product volume in milliliters (for liquids)

image_url
string | null

URL to product image

attributes
Attributes · object

Custom key-value attributes (e.g. {"organic": true, "fat_percent": "2.5"})

barcode
string | null

EAN/UPC barcode

is_active
boolean | null

Set to false to soft-delete the product

Response

Successful Response

sku
string
required

SKU of the updated product

updated_fields
string[]
required

List of field names that were updated

re_embedded
boolean
required

Whether the product was re-embedded due to content field changes