PUT
Update Product
Updates an existing SKU by its ID. Only the provided fields are modified; unspecified fields remain unchanged.
Note
When updating category or subCategory, ensure the arEffect structure matches the new category requirements.
Parameters
skuIdstring
Unique SKU identifier (_id) of the product to update. Returns 404 if not found.
Request body
categorystring
High-level product category. This influences which AR fields and metadata are applicable.
subCategorystring
More specific product type within a category. Must match the selected category.
isActiveboolean
Enables or disables the SKU for try-on visibility without deleting it.
statusstring
Updates the lifecycle state.
productNamestring
Updated display name of the product.
productImagestring
Updated public image URL used in catalog views.
brandstring
Updated brand or manufacturer name.
barcodestring
Updated product identifier (e.g., UPC/EAN or internal code).
actionUrlstring
Updated redirect URL triggered when the product is clicked.
versionstring
Version label for tracking SKU configuration updates.
arEffectobject
AR configuration for the product (assets + rendering settings). Structure varies by category (makeup vs 3D categories)
metaobject
collectionIdsarray of string
List of collection identifiers used to group or organize SKUs.
PUT/skus/{skuId}
curl -X PUT "https://api.pixelbin.io/service/platform/misc/v2.0/skus/{skuId}" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {apitoken}" \
-d '{"category":"eyewear","subCategory":"sunglasses","isActive":true,"status":"PUBLISHED","productName":"Smoke Aviator Test 1","productImage":"https://cdn.pixelbinz0.de/v2/calm-term-553038/original/01_Smoke_Aviator.png","brand":"Generic","barcode":"031000110KY","actionUrl":"https://hellostranger.com","version":"1.0.0","arEffect":{"transform":{"position":{"x":0,"y":0,"z":0.1},"rotation":{"x":0,"y":0,"z":0}},"envSettings":{"SSAOSettings":{},"bloomSettings":{},"useDefaultEnvironment":true},"effectAssets2D":[null,null,null,null,null,null],"effectAssets3D":[{"id":"full","url":"https://cdn.pixelbinz0.de/v2/calm-term-553038/original/Titan_sunglasses_01.glb"}]},"meta":{"dimensions":{}}}'
Response
No example available.