Skip to navigation
API ReferenceProducts

Update Product Variants

View as Markdown
Updates one or more product variants. The request body must be an array of variant objects. Each variant must include the variant ID, and only the fields provided will be updated.

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

OR
AuthorizationBearer
OAuth2 authentication using JWT tokens

Path parameters

productIdlongRequired

Request

This endpoint expects an object.
additional_hazmat_attributesobjectOptional
barcodeslist of objects or nullOptional
bundle_definitionlist of objects or nullOptional
channel_metadatalist of objects or nullOptional
customsobjectOptional
dimensionobjectOptional
fulfillment_settingsobjectOptional
gtinstring or nullOptional
idlongOptional
is_digitalbooleanOptional
lot_informationobjectOptional
namestring or nullOptional
packaging_material_type_idinteger or nullOptional
packaging_requirement_idinteger or nullOptional
return_preferencesobjectOptional
reviews_pendinglist of enums or nullOptional
Allowed values:
skustring or nullOptional
statusenumOptional
Allowed values:
upcstring or nullOptional
weightdoubleOptional

Response

Success
additional_hazmat_attributesobjectOptional
Additional hazardous materials attributes for lithium batteries and dangerous goods
associated_bundleslist of objects or nullOptional
List of bundle products that include this variant as a component
barcodeslist of objects or nullOptional

List of barcodes associated with this variant (UPC, EAN, etc.)

bundle_definitionlist of objects or nullOptional
If this variant is a bundle, defines which variants and quantities make up the bundle
channel_metadatalist of objects or nullOptional

Platform-specific metadata for sales channels (e.g., Amazon ASIN, Shopify product IDs)

created_ondatetimeOptional
Timestamp when the variant was created
customsobjectOptional

Customs and international shipping information (tariff codes, country of origin, declared value)

dimensionobjectOptional

Physical dimensions of the variant (length, width, height)

fulfillment_settingsobjectOptional

Fulfillment-specific settings (Prop 65, dangerous goods, serial scanning, case pick)

gtinstring or nullOptional

Global Trade Item Number - standardized product identifier

idlongOptional
Unique identifier for the variant
inventoryobjectOptional

Current inventory information including on-hand quantity. This is not the source of truth for inventory levels. Use the latest Inventory API for current inventory levels.

is_digitalbooleanOptional

Flag indicating whether this is a digital product (no physical fulfillment)

is_image_uploadedbooleanOptional
Flag indicating whether a product image has been uploaded for this variant
lot_informationobjectOptional
Lot tracking settings including whether lot tracking is enabled and minimum shelf life requirements
merge_childrenlist of objects or nullOptional
List of variants that have been merged into this variant
namestring or nullOptional
Variant name or descriptor
packaging_material_typeobjectOptional

Type of packaging material used for this variant (ID and name)

packaging_requirementobjectOptional

Special packaging requirements for this variant (ID and name)

return_preferencesobjectOptional
Customer return handling preferences including primary and backup actions
reviews_pendinglist of strings or nullOptional

List of pending review types for this variant (e.g., compliance checks, quality reviews)

skustring or nullOptional

Stock Keeping Unit - unique identifier for the variant used in inventory management

statusstring or nullOptional

Current status of the variant (e.g., ‘Active’, ‘Inactive’)

upcstring or nullOptional

Universal Product Code - 12-digit barcode identifier

updated_ondatetime or nullOptional
Timestamp when the variant was last updated
weightobjectOptional
Weight of the variant including unit of measure