← API reference
Mutation / commerce

bulkUpdateOrderStatuses

Update the status of multiple orders at once. Requires order:write.

Arguments

The orders to move, the status to apply, and an optional internal note. Unknown order ids do not abort the batch — they come back in failedOrderIds.

Returns BulkUpdateOrderStatusesPayload!

Scalar fields at a glance

failedOrderIds[OrderID!]
↗ View the complete BulkUpdateOrderStatusesPayload type

Explore in a view

Order Intake
View exact SDL
"""Update the status of multiple orders at once. Requires order:write."""
bulkUpdateOrderStatuses(
  """
  The orders to move, the status to apply, and an optional internal note. Unknown order ids do not abort the batch — they come back in failedOrderIds.
  """
  input: BulkUpdateOrderStatusesInput!
): BulkUpdateOrderStatusesPayload! @topic(names: ["commerce"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.