Delete Promo Code
Delete an existing promotional code.
Endpoint
DELETE /v1/promo-codes/{id}
Authentication
Requires an API key with the promotions:write scope.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
id | integer | The promo code ID |
Example Request
curl -X DELETE "https://app.equipdash.com/api/v1/promo-codes/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 | Promo code belongs to different supplier |
| 404 | resource_not_found | Promo code does not exist |
Notes
- Deleting a promo code 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 promo code