Update product variant

PUT/api/v1/inventory/products/variants/{id}

Update an existing variant.

Operation ID: update_variant_api_v1_inventory_products_variants__id__put·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Path

idstring · uuidrequired

Request body

idstring

Variant UUID (set from URL path).

product_idstring

UUID of the parent product to move this variant under (re-parent). The target product must belong to the same business and must not be archived.

unit_priceinteger

Sale price in cents (e.g., 2999 = $29.99).

namestring

Variant name (e.g., 'Large - Blue').

skustring

Stock Keeping Unit for inventory tracking.

manufacturer_skustring

Manufacturer's SKU for ordering from suppliers.

barcodestring

Scannable barcode (UPC/EAN/QR). Distinct from SKU.

unit_costinteger

Cost price in cents for margin calculations.

unit_cost_precisenumber

Precise unit cost in dollars with sub-cent precision (e.g. 0.0478).

uomstring

Unit of measure: EA, LB, G, KG, OZ, L, ML, etc.

default_vendor_idstring

UUID of the preferred vendor for this variant.

archivedboolean

Set to true to archive (hide) the variant.

initial_inventory_quantityinteger

Set initial inventory count (use when first setting up).

initial_inventory_quantity_datestring · date-time

Date for the initial inventory count (ISO 8601).

Responses

200Successful Response

successboolean
messagestring
codestring
dataVariantResponse

400Bad request - invalid data

404Business or variant not found

422Validation error