Products
Update a variant's price
PATCH
Changes a variant's price and discount. Only the fields you send change. The discount must leave a price above zero. Returns the whole product.
apiKeyheader
AuthorizationBearer <token>A store API key from Settings → Developers → API keys, sent as Authorization: Bearer zk_live_….
id*stringThe resource id
Format
uuidvariant_id*stringThe variant id
Format
uuidIdempotency-Key?stringA unique value (e.g. a UUID) per change. Retrying with the same key returns the first result instead of applying the change twice. Kept for 24 hours.
Length
length <= 255application/json- body
price?stringMatch
^\d{1,8}(\.\d{1,2})?$discount_type?stringnull removes the discount
Value in
"percentage""fixed"discount_value?stringMatch
^\d{1,8}(\.\d{1,2})?$Success
application/json- response
object*"product"Value in
"product"id*stringname*stringName in the store's default language
slug*stringtype*stringValue in
"physical""digital""consulting""webinar"status*stringValue in
"pending""approved""deleted""archived""featured""in_review""draft"currency*stringThe store currency
Length
3 <= length <= 3min_price*stringLowest price after discounts across variants
max_price*stringDecimal amount as a string, e.g. "149.00"
category_id*stringtags*array<string>images*array<string>Public image URLs
translations*array<>variants*array<>created_at*stringISO 8601 timestamp
updated_at*stringISO 8601 timestamp
curl -X PATCH "https://example.com/products/497f6eca-6276-4993-bfeb-53cbbbba6f08/variants/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{}'{ "object": "product", "id": "00000000-0000-4000-8000-0000000000a1", "name": "Classic T-shirt", "slug": "classic-t-shirt", "type": "physical", "status": "approved", "currency": "SAR", "min_price": "108.00", "max_price": "108.00", "category_id": null, "tags": [ "summer" ], "images": [ "https://cdn.example.com/products/classic-t-shirt.jpg" ], "translations": [ { "locale": "en", "name": "Classic T-shirt", "description": "100% cotton." }, { "locale": "ar", "name": "تيشيرت كلاسيكي", "description": "قطن ١٠٠٪." } ], "variants": [ { "object": "product_variant", "id": "00000000-0000-4000-8000-0000000000b1", "product_id": "00000000-0000-4000-8000-0000000000a1", "title": "Medium / Black", "sku": "TSHIRT-M-BLK", "barcode": null, "price": "120.00", "discount_type": "percentage", "discount_value": "10.00", "stock": 42, "low_stock_threshold": 5, "option1": "Medium", "option2": "Black", "option3": null, "position": 1, "image_url": null, "created_at": "2026-09-01T08:00:00.000Z", "updated_at": "2026-10-01T09:30:00.000Z" } ], "created_at": "2026-09-01T08:00:00.000Z", "updated_at": "2026-10-01T09:30:00.000Z"}