Remove a discount from an order

DELETE 
/v1/orders/:id/discounts/:discountId

Removes a discount from an order and returns it with the totals recalculated.

Unlike items and payments, a discount is deleted rather than kept as cancelled: it never represented a promise to the customer or a movement of money, so there is nothing to keep on the order.

This also removes a coupon applied with POST /v1/orders/{id}/coupon: the totals are restored immediately and the order status is not checked, but the redemption stays counted against the coupon usage limit.

Only orders created through the API can be changed here. An order taken on the storefront, the POS or a food app belongs to that channel and answers 422 order_not_modifiable.

Required scope: orders:write

Request

Responses

200

The order without the discount.

401

Unauthenticated — the request is missing a credential, or the Bearer token / API key is invalid, expired, or revoked.

403

Insufficient scope — the credential is authenticated but lacks a scope the endpoint requires.

404

Not found — no resource matches the id in the path (or it belongs to a different company).

422

Validation failed — the request body failed schema validation. errors[] lists every offending field.