Appearance
BulkUpdateOrderStatusesInput
Type: Input
Applies one status — and optionally one internal note — to a batch of up to 100 orders.
Fields
| Name | Type | Default | Description |
|---|---|---|---|
| notes | String | Optional internal note. When given it OVERWRITES the internal notes of every updated order; when null, existing notes are left untouched. | |
| orderIds | [OrderID!]! | Orders to move, as OrderID TypeIDs (e.g. "ord_01K…"). At least 1 and at most 100; outside that range nothing is updated and the payload carries a validation error on orderIds. Ids that do not resolve to an order in the caller's tenant are reported in failedOrderIds and do not block the rest. | |
| status | OrderStatus! | Status applied to every order that was found. Set unconditionally — no transition validation is performed. Side effects on the order: CANCELLED stamps cancelledAt, COMPLETED stamps completedAt, and CONFIRMED stamps confirmedAt only if it was not already set. |