Skip to main content

Delete a product

DELETE 
/api/v1/sdk/products/:productId

This endpoint soft-deletes a product, removing it from active listings but preserving data for order history and recovery.

Authentication: Requires Private API Key (sk_*)

Deletion Behavior:

  • Product is soft-deleted (marked as deleted, not physically removed)
    • Product is removed from search and catalog listings
    • Existing orders and history retain product information
    • Product can be recovered by support if needed
    • Active cart items with this product are removed

Use Cases:

  • Removing discontinued products
    • Cleaning up product catalog
    • Synchronizing deletions from external platforms

Important Notes:

  • This operation cannot be undone via API (requires support intervention)
    • Consider setting product to inactive instead if temporary removal needed
    • Historical order data is preserved

Error Scenarios:

  • 404 NOT FOUND - Product not found (Error code: PRODUCT_NOT_FOUND)
    • 400 BAD REQUEST - Invalid product ID format (Error code: INVALID_REQUEST)
    • 401 UNAUTHORIZED - Invalid or missing API key (Error code: INVALID_API_KEY)
    • 403 FORBIDDEN - API key doesn't have access to this store (Error code: NO_STORE_ACCESS)

Request​

Responses​

Product deleted successfully (soft delete)