reduceInventory

Reduce inventory by first reducing available, then moving committed to backordered. If insufficient inventory exists, additional available inventory is…

mutation

Requires commerce.product:write.

Reduce inventory by first reducing available, then moving committed to backordered. If insufficient inventory exists, additional available inventory is automatically added to fulfill the reduction. This mutation does not respect backorder limits.

Required headers

Header	Required	Description
`x-store-id`	Yes	ID of the store the operation targets. Omitting it returns HTTP 200 with a GraphQL error: `extensions.code: "UNAUTHENTICATED"`.

Go to Authentication for credential setup.

Arguments

input MutationReduceInventoryInput! required
- locationId ID! required
- quantity Int! required
- skuId ID! required
- reasonName String optional
- references [CreateReferenceInput!] optional
  - origin String! required
  - value String! required

Possible returns

InventoryAdjustment [InventoryAdjustment!] — An immutable entity that represents a change in state of a quantity of SKU at a particular time and location.

mutation RunReduceInventory($input: MutationReduceInventoryInput!) {  reduceInventory(input: $input) {    id    type    delta    createdAt    occurredAt  }}

{  "data": {    "reduceInventory": [      {        "id": "ID_VALUE",        "type": "TYPE_VALUE",        "delta": 1,        "createdAt": "2026-01-15T12:00:00.000Z",        "occurredAt": "2026-01-15T12:00:00.000Z"      }    ]  }}

Last updated on