Skip to main content
PUT
Update Product
Updates the parent product identified by skuId. First GET the complete parent product with identifierType=product. Include all required fields and the complete variants array; this is a full replacement, not a partial patch. expectedUpdatedAt is optional for compatibility: omit it to update without a stale-write check. To detect concurrent changes, copy GET sku.updatedAt verbatim into expectedUpdatedAt, including JSON null only if GET returned null; never generate or normalize the timestamp. Leaving this field blank in the Playground omits it. Use the parent product _id in the path and preserve existing variant IDs. Remove the sku envelope, organization/timestamps and populated file objects from the update body; send fileRefId references instead. On 409 STALE_PRODUCT, refetch the complete parent product and review your changes before submitting an updated body and revision; do not automatically retry.
Note
When updating product categories, ensure the variants contain the try-on configuration required for the updated product.

Parameters

skuIdstring
Parent product UUID exactly as returned by the API. This authoring route does not resolve merchant SKUs or variant IDs and does not use identifierType.

Request body

expectedUpdatedAtstring
Optional stale-write check: copy the latest complete GET sku.updatedAt verbatim. If GET returned null, send JSON null (enter null in the Playground), not the string "null". Never generate or normalize this timestamp. Omit to update without a revision check; leave blank in the Playground to omit.
_idstring
Immutable product UUID, globally unique regardless of letter casing. Generated when omitted on create. Preserve the returned spelling for subsequent requests; merchant SKU IDs belong on variants.
categorystring
Use nail (singular) for nail-polish and nail-art; do not rename it to nails.
subCategorystring
Must belong to the selected category. Use nail/nail-polish or nail/nail-art for nails.
statusstring
PUBLISHED requires a usable try-on setup on every variant. DRAFT and UNPUBLISHED may be configured incrementally. Bulk upload accepts only DRAFT.
productNamestring
Required and non-empty unless this is an inactive DRAFT.
productImagestring
Product thumbnail URL. Required and non-empty unless this is an inactive DRAFT. Illustrative example URLs must be replaced with real assets.
brandstring
Required and non-empty unless this is an inactive DRAFT.
isActiveboolean
barcodestring
Optional product barcode. Each variant may also have its own barcode.
collectionIdsarray of string
additionalProductDetailsobject
variantAxesarray of object (item)
Empty for a single variant without options. Non-empty axes define the choices referenced by variantValues.
primaryVariantAxisIdstring
Must reference an axis id. Required when more than one axis is defined; otherwise omit or use null.
mediaarray of object (item)
Product gallery. Supply complete embedded file metadata or existing same-organization image/video fileRefId references.
variantsarray of object (item)
Ordered product variants with unique UUIDs. The first variant is initially selected; do not send a literal default ID. Merchant SKU IDs belong in variants[].skuId.
PUT/skus/{skuId}
curl -X PUT "https://api.glamar.fynd.com/service/platform/glamar/v3.0/skus/54d7bb83-a0bb-4aa4-8066-8752c96fb739" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {apitoken}" \
-d '{"schemaVersion":3,"category":"makeup","subCategory":"lipstick","status":"PUBLISHED","productName":"Matte Red Lipstick","productImage":"https://cdn.example.com/lipstick.png","brand":"Example","version":"1.0.0","isActive":true,"barcode":"","collectionIds":[],"additionalProductDetails":{},"variantAxes":[],"primaryVariantAxisId":null,"media":[],"variants":[{"_id":"4fd0ab3d-47da-45c4-858d-f0fcce540d5a","skuId":"lipstick-red","variantValues":[],"pricing":{"price":19.99},"meta":{},"tryOn3D":{"styleID":"single","colors":[{"colorId":"red","color":"#B93445"}],"patterns":[{"_id":"matte","colorIntensity":70}]},"productId":"54d7bb83-a0bb-4aa4-8066-8752c96fb739"}]}'
Response
No example available.