Delete a product
Products
Delete Product
Delete a card product. Permanently removes it if no active cards exist, or archives it automatically if cards are still in use. DELETE /products/. Requires accounts:write scope.
DELETE
Delete a product
Overview
Smart delete: a singleDELETE call handles both cases automatically.
| Condition | What happens | data.action |
|---|---|---|
| Product has no active cards | Permanently deleted — cannot be recovered | "deleted" |
| Product has active cards | Archived — no new cards can be issued, existing cards unaffected | "archived" |
data.action in the response to know what was done. Archived products can be restored with POST /products/{id}/activate.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | string | The product ID (prefix prd_) |
Example
Success Response (200) — Permanently Deleted
Success Response (200) — Archived (Has Active Cards)
Error Codes
| Code | HTTP | Cause |
|---|---|---|
PRODUCT_NOT_FOUND | 404 | Product does not exist or belongs to another business |
INSUFFICIENT_SCOPE | 403 | Key lacks accounts:write scope |
INTERNAL_ERROR | 500 | Server error |

