Skip to main content
POST
/
admin
/
products
/
{id}
/
variants
/
{variant_id}
curl -X POST 'http://localhost:9000/admin/products/prod_01HXYZABCDEF/variants/variant_01HXYZABCDEF' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"sku": "LS-M-2026"}'
{
  "product": {
    "id": "prod_01HXYZABCDEF",
    "title": "Linen Shirt",
    "variants": [
      { "id": "variant_01HXYZABCDEF", "title": "M", "sku": "LS-M-2026" }
    ]
  }
}
Updates the variant and returns the parent product.

Path parameters

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

Body parameters

title
string
Variant title.
sku
string
Variant SKU.
ean
string
Variant EAN.
upc
string
Variant UPC.
isbn
string
Variant ISBN.
asin
string
Variant ASIN.
gtin
string
Variant GTIN.
barcode
string
Variant barcode.
hs_code
string
Harmonized System code.
mid_code
string
Manufacturer identification code.
thumbnail
string
URL of the variant thumbnail.
variant_rank
number
Sort rank of the variant.
weight
number
Variant weight.
length
number
Variant length.
height
number
Variant height.
width
number
Variant width.
origin_country
string
Country of origin.
material
string
Variant material.
prices
object[]
Variant prices.
options
object
Map of option title to option value.
metadata
object
Custom key-value data.
additional_data
object
Custom data passed to workflow hooks.

Response

product
object
curl -X POST 'http://localhost:9000/admin/products/prod_01HXYZABCDEF/variants/variant_01HXYZABCDEF' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"sku": "LS-M-2026"}'
{
  "product": {
    "id": "prod_01HXYZABCDEF",
    "title": "Linen Shirt",
    "variants": [
      { "id": "variant_01HXYZABCDEF", "title": "M", "sku": "LS-M-2026" }
    ]
  }
}