Delete Voucher
Delete an existing voucher or gift card.
Endpoint
DELETE /v1/vouchers/{id}
Authentication
Requires an API key with the promotions:write scope.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | integer | The voucher ID |
Example Request
curl -X DELETE "https://app.equipdash.com/api/v1/vouchers/1" \
-H "Authorization: Bearer YOUR_API_KEY"
Response
Returns 204 No Content on success.
Errors
| Status | Code | Description |
|---|---|---|
| 401 | authentication_required | No API key provided |
| 403 | insufficient_scope | API key lacks promotions:write scope |
| 403 | forbidden | Voucher belongs to different supplier |
| 404 | resource_not_found | Voucher does not exist |
Notes
- Deleting a voucher is permanent and cannot be undone
- Historical usage records are preserved for reporting purposes
- Consider setting the status to
inactiveinstead if you want to preserve the voucher - Refunded or used vouchers should typically be kept for audit purposes