Skip to main content
DELETE
/
vendor
/
products
/
{id}
/
variants
/
{variant_id}
curl -X DELETE 'http://localhost:9000/vendor/products/prod_01HXYZ/variants/variant_01HXYZ' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>'

{
  "product_change": {
    "id": "prodch_01HXYZ",
    "product_id": "prod_01HXYZ",
    "status": "pending",
    "actions": [
      {
        "id": "prodchact_01HXYZ",
        "action": "VARIANT_REMOVE",
        "details": { "variant_id": "variant_01HXYZ" },
        "applied": false
      }
    ]
  }
}
Stages a VARIANT_REMOVE operation as a pending change request instead of deleting the variant directly.
The endpoint responds with 202 Accepted and a product_change record; the variant remains until the change is confirmed.

​
Path parameters

​
id
string
required
The product’s ID.
​
variant_id
string
required
The variant’s ID.

​
Response

​
product_change
object
curl -X DELETE 'http://localhost:9000/vendor/products/prod_01HXYZ/variants/variant_01HXYZ' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>'

{
  "product_change": {
    "id": "prodch_01HXYZ",
    "product_id": "prod_01HXYZ",
    "status": "pending",
    "actions": [
      {
        "id": "prodchact_01HXYZ",
        "action": "VARIANT_REMOVE",
        "details": { "variant_id": "variant_01HXYZ" },
        "applied": false
      }
    ]
  }
}