Delete an Order Item

Removes a line item from an order and recalculates the order totals. This cannot be undone.

delete

Authorizations

ORDERDESK-API-KEYstringRequired

Your API key, found under Store Settings on the API tab. This should be kept server-side.

ORDERDESK-STORE-IDstringRequired

Your store ID, found under Store Settings on the API tab.

Path parameters

order_idintegerRequired

Order Desk's internal order ID. This is not your source_id.

Example: 736745

item_idintegerRequired

Order Desk's internal ID for the order item.

Example: 1670028

Responses

200

The item was deleted.

application/json

statusstring · enumRequired

Either success or error.

Possible values:

messagestringOptional

Describes the result. Always present when an error occurs.

execution_timestringOptional

Time taken to process the request.

Example: 0.1524 seconds

401

Authentication failed. See the Authentication guide, and note that an invalid store ID blocks your store rather than simply failing the request.

application/json

404

No record matches that ID in your store.

application/json

429

You are sending too fast. Wait X-Retry-After seconds. See the Rate Limits guide.

application/json

default

The request could not be completed.

application/json

delete/orders/{order_id}/order-items/{item_id}

curl "https://app.orderdesk.me/api/v2/orders/736745/order-items/1670028" \
  -X DELETE \
  -H "ORDERDESK-STORE-ID: your-store-id" \
  -H "ORDERDESK-API-KEY: your-api-key"

{
  "status": "success",
  "message": "Order Item Deleted",
  "execution_time": "0.0836 seconds"
}