Skip to main content
POST
/
admin
/
products
/
{id}
/
request-changes
curl -X POST 'http://localhost:9000/admin/products/prod_01HXYZABCDEF/request-changes' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"message": "Please add size measurements to the description"}'

{
  "product": {
    "id": "prod_01HXYZABCDEF",
    "title": "Linen Shirt",
    "status": "proposed",
    "updated_at": "2026-06-02T09:00:00.000Z"
  }
}
Flags the product as requiring action and records a message for the vendor.

​
Path parameters

​
id
string
required
The product’s ID.

​
Query parameters

​
fields
string
Comma-separated list of fields to include, prefix with +/- to add or remove from defaults.

​
Body parameters

​
message
string
Message describing the requested changes, shared with the vendor.

​
Response

​
product
object
curl -X POST 'http://localhost:9000/admin/products/prod_01HXYZABCDEF/request-changes' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"message": "Please add size measurements to the description"}'

{
  "product": {
    "id": "prod_01HXYZABCDEF",
    "title": "Linen Shirt",
    "status": "proposed",
    "updated_at": "2026-06-02T09:00:00.000Z"
  }
}