Delete a product permanently.
Permanent and irreversible. Removes the product row + any uploaded documents whose only reference was this product (documents linked to other products/passports stay, just with productId unset), and the stored files that belonged only to this product.
Only products with ZERO passports of any status are eligible — including archived. The rule preserves audit history: an archived passport carries the regulatory story ("we published this, then withdrew it") that would be orphaned if the parent product disappeared.
Paid-plan feature. Returns 403 on Free plans; use the archive endpoint instead.
Honours Idempotency-Key. No webhook.
Request
- Base URL: https://app.tracepass.eu
- URL: https://app.tracepass.eu/api/v1/products/{id}
- Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://app.tracepass.eu/api/oauth/authorize, token URL https://app.tracepass.eu/api/oauth/token, scopes: passports:write)
Headers
UUID v4 (or any opaque string ≤ 64 chars) per logical operation. The platform stores the first response for 24 hours and replays it on the same key + same workspace. Reusing the same key with a different request body returns 422.
Response
Permanently deleted; summary includes cascade counts.
Changes
No recorded changes to this operation across all 1 revision of this API.