Delete Single Product API

Overview

Deletes a single product by identity. This operation marks the product as inactive rather than permanently removing it from the catalog.

Method

DELETE

Endpoint

DELETE /v2/catalogs/{catalogId}/products/{productId}

Base URL

https://in1.api.clevertap.com/v2/catalogs/{catalogId}/products/{productId}

Region

Refer Region for more details.

Headers

These headers must be included with every API request to ensure authentication and correct request handling.

HeaderDescriptionRequired
Content-TypeContent type of the request. Must be application/json.Yes
X-CleverTap-Account-IdCleverTap account ID associated with the catalog.Yes
X-CleverTap-PasscodeAPI passcode used to authenticate the request.Yes

Path Parameters

The following path parameters are required to identify the product to delete.

ParameterTypeRequiredDescription
catalogIdNumberYesUnique identifier of the catalog from which products are deleted.
productIdStringYesUnique identifier of the product (URL encoded)

Example Request

This example deletes a product from the catalog:

DELETE /v2/catalogs/123/products/SKU-12345

Example Response

This example response indicates that the delete request was processed successfully.

{
  "message": "Operation completed successfully"
}

Response Parameters

The response returns a confirmation message indicating that the product was deleted successfully.

ParameterTypeDescription
messagestringConfirmation message indicating that the operation was completed successfully.

Error Codes

This API returns a standard HTTP status code along with a plain-text message describing the issue. Common status codes include:

HTTP StatusDescription
400The request is invalid, missing required fields, or exceeds a bulk limit (product count or payload size).
403The caller lacks permission, or the catalog feature is not enabled for this account.
404The specified catalog or product does not exist.
409A conflicting resource already exists.
413The request payload exceeds the maximum allowed size.
500An unexpected server-side error occurred.

Did this page help you?
CleverTap Ask AI Widget (CSP-Safe)