Batch update order items

PATCH /v1/orders/{orderId}/items/batch

Batch update order items

Requires: order.edit

Path Parameters

orderId required

string

The order's unique identifier

Request Body

Array of item updates with item IDs and changes

RequestBody

value

object[]

Example Request

application/json

[
  {
    "itemId": "string",
    "changes": {
      "customMetadata": {},
      "quantity": 1
    }
  }
]

Response Schema

Response

value

object[]

Example Response

200 OK — application/json

[
  {
    "orderId": "string",
    "quantity": 1,
    "customMetadata": {},
    "id": "string",
    "storeId": "string",
    "createdAt": "2026-09-09T20:31:46.819Z",
    "updatedAt": "2026-09-09T20:31:46.819Z"
  }
]