Delete a product
DELETE /rest/v1/products/{id}
Archives the product (soft delete). Its images are kept for 30 days, so it can be brought back with POST /products/{id}/restore or by undoing the action; after that they are removed. A product with LIVE listings cannot be deleted: while any listing is listed or ongoing, or in error but still present on the channel (it has an id_on_channel), this returns 422 product_still_listed. Delist each listing first (DELETE /listings/{id}). A delist runs in the background: while it is still running the listing is ongoing and this returns 409 listing_operation_in_progress instead. Wait for the delist to finish (operation.completed webhook, or poll the listing until it is delisted), then delete. Both errors list the listings in error.details.listing_ids. This mirrors the platform invariant: Nembol never forgets a product that is still live on a channel. Deleting does not touch any channel. Otherwise the product is archived at once and the response is a 202 Operation, already succeeded.
Required scope: products:write.
Authorization
apiKey Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.
In: header
Path Parameters
Header Parameters
Unique client-generated key (max 255 chars), stored 24h.
length <= 255Response Body
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/products/string"{ "id": "op_8fd2c1", "object": "operation", "type": "string", "status": "pending", "resource_type": "string", "resource_id": "string", "results": [ { "channel_account_id": "string", "product_id": "string", "listing_id": "string", "sku": "string", "variant_id": "string", "previous_price": "19.90", "price": "19.90", "status": "pending", "error": { "code": "string", "message": "string", "details": {} } } ], "import": { "source": "channel", "channel_account_id": "string", "filters": {}, "warnings": [ "string" ], "processed": 0, "total": 0, "created": 0, "updated": 0, "unchanged": 0, "linked": 0, "not_imported": 0, "requires_attention": 0, "error": "string", "undone_at": "2019-08-24T14:15:22Z", "undo": { "removed": 0, "unlinked": 0, "kept": { "live_on_a_channel": 0, "modified_after_import": 0 } } }, "created_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z"}Last updated on October 22, 2026
Need help?
Email us and a human replies, usually within one business day.