Error
A valid request URL is required to generate request examples{
"id": "<string>",
"object": "product",
"deleted": true
}{
"error": {
"code": "INVALID_REQUEST",
"message": "invalid request body"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "PRODUCT_NOT_FOUND",
"message": "product not found"
}
}{
"error": {
"code": "PRODUCT_DELETION_UNSUPPORTED",
"message": "products cannot be deleted; deactivate the product instead"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Products and prices
Delete a product
Deletes a product. Returns 422 PRODUCT_HAS_PRICES when the product still has
associated prices, or 422 PRODUCT_DELETION_UNSUPPORTED when deletion is disabled
for this resource. To archive a product without deleting, update it with
active: false.
DELETE
/
products
/
{id}
Error
A valid request URL is required to generate request examples{
"id": "<string>",
"object": "product",
"deleted": true
}{
"error": {
"code": "INVALID_REQUEST",
"message": "invalid request body"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "PRODUCT_NOT_FOUND",
"message": "product not found"
}
}{
"error": {
"code": "PRODUCT_DELETION_UNSUPPORTED",
"message": "products cannot be deleted; deactivate the product instead"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Authorizations
A merchant secret key (sk_…) sent as Authorization: Bearer <key>.
Headers
Merchant ID when an authorized Platform acts for a connected Merchant. Omit when authenticating directly as that Merchant.
Pattern:
^mer_[0-9A-Za-z]{14}$A unique key that makes retries safe: the same key with the same request body returns the original response instead of repeating the operation.
Maximum string length:
255Path Parameters
The product id (prod_…).