Remove an item from an order

DELETE 
/v1/orders/:id/combos/:comboId

Cancels one item of an order and returns the order with its totals recalculated.

The item is not erased: it stays on the order with canceled_at set, so the change remains auditable and shows up in the merchant reports. Items that were already sent to the kitchen are pulled from the kitchen display as well.

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 cancelled item.

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.