Skip to main content
POST
/
vendor
/
products
/
{id}
/
variants
/
{variant_id}
curl -X POST 'http://localhost:9000/vendor/products/prod_01HXYZ/variants/variant_01HXYZ' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>' \
  -H 'Content-Type: application/json' \
  -d '{"sku": "ACME-SHIRT-M-V2", "weight": 200}'

{
  "product_change": {
    "id": "prodch_01HXYZ",
    "product_id": "prod_01HXYZ",
    "status": "pending",
    "actions": [
      {
        "id": "prodchact_01HXYZ",
        "action": "VARIANT_UPDATE",
        "details": { "variant_id": "variant_01HXYZ", "fields": { "sku": "ACME-SHIRT-M-V2" } },
        "applied": false
      }
    ]
  }
}
Stages a VARIANT_UPDATE operation as a pending change request instead of updating the variant directly.
The endpoint responds with 202 Accepted and a product_change record, not the updated variant.

​
Path parameters

​
id
string
required
The product’s ID.
​
variant_id
string
required
The variant’s ID.

​
Body parameters

​
title
string
The variant’s title.
​
sku
string
The variant’s SKU.
​
ean
string
EAN barcode.
​
upc
string
UPC barcode.
​
isbn
string
ISBN code.
​
asin
string
Amazon ASIN.
​
gtin
string
GTIN code.
​
barcode
string
Generic barcode.
​
hs_code
string
Harmonized System code.
​
mid_code
string
Manufacturer ID code.
​
thumbnail
string
Variant thumbnail URL.
​
variant_rank
number
Sort rank of the variant.
​
weight
number
Weight of the variant.
​
length
number
Length of the variant.
​
height
number
Height of the variant.
​
width
number
Width of the variant.
​
origin_country
string
Country of origin.
​
material
string
Material of the variant.
​
allow_backorder
boolean
Whether backorders are allowed.
​
manage_inventory
boolean
Whether inventory is managed for the variant.
​
metadata
object
Custom key-value pairs.
​
options
object
Option title to value mapping, e.g. {"Size": "M"}.
​
images
object

​
Response

​
product_change
object
curl -X POST 'http://localhost:9000/vendor/products/prod_01HXYZ/variants/variant_01HXYZ' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>' \
  -H 'Content-Type: application/json' \
  -d '{"sku": "ACME-SHIRT-M-V2", "weight": 200}'

{
  "product_change": {
    "id": "prodch_01HXYZ",
    "product_id": "prod_01HXYZ",
    "status": "pending",
    "actions": [
      {
        "id": "prodchact_01HXYZ",
        "action": "VARIANT_UPDATE",
        "details": { "variant_id": "variant_01HXYZ", "fields": { "sku": "ACME-SHIRT-M-V2" } },
        "applied": false
      }
    ]
  }
}