> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercurjs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Update Product
> Stage an update to a product as a change request.
Does not modify the product directly — it stages a pending change request that an operator confirms or declines.
The endpoint responds with `202 Accepted` and a `product_change` record, not the updated product. Use [Preview Product Change](/rc/references/api/vendor/products/preview-product) to inspect the pending change and [Cancel Product Change](/rc/references/api/vendor/products/cancel-product-change) to withdraw it.
## Path parameters
The product's ID.
## Body parameters
The product's title.
The product's subtitle.
The product's description.
Whether discounts can apply to the product.
Whether the product is a gift card.
Existing image ID to keep.
Image URL.
URL of the product's thumbnail image.
The product's URL handle.
ID of the product in an external system.
ID of the product type.
ID of the collection the product belongs to.
Category ID.
Tag ID.
Option title.
Allowed option values.
Variant updates staged with the change.
Existing variant ID to update.
Variant title.
Variant SKU.
EAN barcode.
UPC barcode.
ISBN code.
Amazon ASIN.
GTIN code.
Generic barcode.
Harmonized System code.
Manufacturer ID code.
Variant thumbnail URL.
Sort rank of the variant.
Weight of the variant.
Length of the variant.
Height of the variant.
Width of the variant.
Country of origin.
Material of the variant.
Custom key-value pairs.
Option title to value mapping.
Weight of the product.
Length of the product.
Height of the product.
Width of the product.
Harmonized System code.
Manufacturer ID code.
Country of origin.
Material of the product.
Custom key-value pairs.
Extra data passed to workflow hooks.
## Response
The change request's ID.
ID of the product the change targets.
One of `pending`, `confirmed`, `declined`, `canceled`.
ID of the seller that staged the change.
Staged operations, each with `id`, `action` (e.g. `UPDATE`), `details`, `ordering`, and `applied`.
Internal note attached to the change.
Note from the operator, e.g. a revision request.
```bash cURL theme={null}
curl -X POST 'http://localhost:9000/vendor/products/prod_01HXYZ' \
-H 'Authorization: Bearer ' \
-H 'x-seller-id: ' \
-H 'Content-Type: application/json' \
-d '{"title": "Acme T-Shirt v2", "description": "Softer fabric."}'
```
```ts JS Client theme={null}
const { product_change } = await client.vendor.products.$id.mutate({
$id: "prod_01HXYZ",
title: "Acme T-Shirt v2",
description: "Softer fabric.",
})
```
```json 202 theme={null}
{
"product_change": {
"id": "prodch_01HXYZ",
"product_id": "prod_01HXYZ",
"status": "pending",
"created_by": "sel_01HXYZ",
"actions": [
{
"id": "prodchact_01HXYZ",
"action": "UPDATE",
"details": { "title": "Acme T-Shirt v2" },
"applied": false
}
]
}
}
```