← API reference
CANONICAL TYPE REFERENCE

BulkUpdateOrderStatusesPayload

Result of a bulk order status update. Partial success is expected: unknown ids are reported in failedOrderIds and errors while the orders that were found are still committed together.

The orders that were found and updated, in their new state. Written in a single transaction, so this batch is all-or-nothing: if any save fails the mutation errors out and no order is changed. Null when input validation rejected the request before any write.

Requested ids that matched no order in the caller's tenant, as OrderID TypeIDs. These are skipped — the remaining orders are still updated. Null (not an empty list) when every id resolved, and null when validation rejected the request outright.

Field-level errors: one entry on orderIds per id that was not found, or a single orderIds entry when the batch was empty or larger than 100. A non-empty errors list alongside a non-empty updatedOrders is the normal partial-success shape.

View exact SDL
"""
Result of a bulk order status update. Partial success is expected: unknown ids are reported in failedOrderIds and errors while the orders that were found are still committed together.
"""
type BulkUpdateOrderStatusesPayload {
  """
  The orders that were found and updated, in their new state. Written in a single transaction, so this batch is all-or-nothing: if any save fails the mutation errors out and no order is changed. Null when input validation rejected the request before any write.
  """
  updatedOrders: [OrderState!]
  """
  Requested ids that matched no order in the caller's tenant, as OrderID TypeIDs. These are skipped — the remaining orders are still updated. Null (not an empty list) when every id resolved, and null when validation rejected the request outright.
  """
  failedOrderIds: [OrderID!]
  """
  Field-level errors: one entry on orderIds per id that was not found, or a single orderIds entry when the batch was empty or larger than 100. A non-empty errors list alongside a non-empty updatedOrders is the normal partial-success shape.
  """
  errors: [FieldError!]!
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.