# Delete Product

The Delete Product API enables you to remove products or specific product variants from your Fynd Commerce catalog. Deletions are processed asynchronously through the same batch processing system, allowing you to delete multiple products or variants in a single API request. Each deletion submission returns a `trace_id` for monitoring processing status.

Product deletions in Fynd Commerce support flexible removal options - you can delete entire products, specific product variants, or multiple products in bulk. The deletion scope is determined by the fields you include in the request payload.

Irreversible Action
1. Product and variant deletions are **permanent and cannot be undone**. Ensure you have verified the products/variants to be deleted before submitting the request. Consider exporting product data before performing bulk deletions
2. Deleting products that have active or recent orders may impact order fulfillment and reporting. Ensure all orders are fulfilled or canceled before deleting products


> **Request Type:** `DELETE`
**Scheme:** `HTTPS`
**Endpoint:** `https://{{host}}/v3/catalog/product`


Try out Fynd Konnect's Delete Product Endpoint
br
**Common Request Headers**

| Header | Mandatory | Description |
|  --- | --- | --- |
| `x-access-token` | Yes | Access token used for authenticating API requests to Fynd Konnect |
| `Content-Type` | Yes | `application/json` |


Deletion Scenarios
* Delete entire products that are discontinued or no longer sold
* Remove specific product variants that are out of stock permanently
* Bulk delete multiple products during catalog cleanup operations
* Remove products before catalog migration or restructuring
* Delete test products created during integration development


### Request Body Schema

Deletion Scope
**To delete an entire product:**

* Include only: `slug`, `brand`, `item_code`, and `template`
* Do NOT include the `sizes` array


**To delete specific product variants:**

* Include: `slug`, `brand`, `item_code`, `template`, and the `sizes` array
* In the `sizes` array, specify only the `primary_identifier` of variants to delete


### Success Response

### API Call Example

### Example Response


```json
{
    "trace_id": "a736437f4c389a5f-1760266316425",
    "total": 1,
    "success": 1,
    "failed": 0,
    "status": "SUCCESS",
    "errors": {},
    "stage": "RUNNING",
    "batch_id": "68eb884c9955e2f2705c9819",
    "company_id": 6900,
    "last_updated_on": "2025-10-12T10:51:56.752438370Z"
}
```

#### Product Deletion Scenarios

Delete Entire Product
Delete a complete product with all its product variants:

**Request Body:**


```json
  {
    "products": [
      {
        "slug": "air-coolers-12337390",
        "brand": "Generic",
        "item_code": "AIRCOOL"
      }
    ],
    "template": "air-care"
  }
```

**Response:**


```json
  {
    "trace_id": "a736437f4c389a5f-1760266316425",
    "total": 1,
    "success": 1,
    "failed": 0,
    "status": "SUCCESS",
    "errors": {},
    "stage": "RUNNING",
    "batch_id": "68eb884c9955e2f2705c9819",
    "company_id": 6900,
    "last_updated_on": "2025-10-12T10:51:56.752438370Z"
  }
```

Delete Specific Size
Delete only a specific product variant while keeping the product:

**Request Body:**


```json
  {
    "products": [
      {
        "slug": "aircoolers",
        "brand": "Generic",
        "item_code": "AIRCOOL",
        "sizes": [
          {
            "primary_identifier": "8904578390999"
          }
        ]
      }
    ],
    "template": "air-care"
  }
```

**Response:**


```json
  {
    "trace_id": "a53228c99c8a076c-1760266423389",
    "total": 1,
    "success": 1,
    "failed": 0,
    "status": "SUCCESS",
    "errors": {},
    "stage": "RUNNING",
    "batch_id": "68eb88b79955e2f2705c981a",
    "company_id": 6900,
    "last_updated_on": "2025-10-12T10:53:43.738514010Z"
  }
```

Delete Multiple Products
Delete multiple complete products in a single request:

**Request Body:**


```json
  {
    "products": [
      {
        "slug": "air-coolers-12337390",
        "brand": "Generic",
        "item_code": "AIRCOOL"
      },
      {
        "slug": "tower-fan-12337391",
        "brand": "Generic",
        "item_code": "WNDWAC"
      }
    ],
    "template": "air-care"
  }
```

**Response:**


```json
  {
    "trace_id": "b3bbaead9858e85d-1760266497372",
    "total": 2,
    "success": 2,
    "failed": 0,
    "status": "SUCCESS",
    "errors": {},
    "stage": "RUNNING",
    "batch_id": "68eb89029955e2f2705c981b",
    "company_id": 6900,
    "last_updated_on": "2025-10-12T10:54:59.058168372Z"
  }
```

#### Common Deletion Errors

details
summary
Err: Product Not Found

- **Cause:** The combination of `slug`, `brand`, and `item_code` doesn't match any existing product.
- **Solution:** Verify the product identifiers using the [Fetch Products](./get-products) endpoint before deletion.

details
summary
Err: Invalid Size Identifier

- **Cause:** The `primary_identifier` in the sizes array doesn't exist for the specified product
- **Solution:** Fetch the product details to confirm available product variants and their identifiers

details
summary
Err: Last Size Deletion

- **Cause:** Attempting to delete the last remaining product variant of a product.
- **Solution:** If deleting the last size, omit the `sizes` array to delete the entire product instead.

### Best Practices

1. **Verify before deleting**: Use [Fetch Products](/konnect/channels/erp-wms/api-documentation/catalog/get-products) to confirm product details before deletion
2. **Export data first**: Export product data before bulk deletions for backup purposes
3. **Test with single products**: Start with single product deletions before scaling to bulk operations
4. **Track with `trace_id`**: Always save the `trace_id` and monitor deletion status
5. **Handle validation errors**: Check the `errors` object for details on failed deletions
6. **Consider deactivation**: For temporary removal, consider marking products inactive instead of deleting
7. **Delete in batches**: For large-scale deletions, break into manageable batches of 50-100 products
8. **Coordinate with inventory**: Ensure inventory is cleared or transferred before deleting products
9. **Check dependencies**: Verify no active orders exist for products being deleted
10. **Document deletions**: Maintain logs of deleted products for audit and compliance purposes


Next Steps
* To check deletion processing status, see [Check Product Status](/konnect/channels/erp-wms/api-documentation/catalog/get-product-status)
* To verify product deletion, see [Fetch Products](/konnect/channels/erp-wms/api-documentation/catalog/get-products)
* To create new products, see [Create Product](/konnect/channels/erp-wms/api-documentation/catalog/post-create-product)
* To update existing products, see [Update Product](/konnect/channels/erp-wms/api-documentation/catalog/put-update-product)
* For complete catalog management workflow, see [Catalog Management Guide](/konnect/channels/erp-wms/whats-new/catalog-management)