releaseInventory

Release inventory from committed and/or backordered. Releases from committed first, then backordered. Errors if the requested quantity exceeds committed +…

mutation

Requires commerce.product:write.

Release inventory from committed and/or backordered. Releases from committed first, then backordered. Errors if the requested quantity exceeds committed + backordered.

releaseInventory decreases COMMITTED first, then BACKORDERED. It does not increase AVAILABLE. To move units back to AVAILABLE, use restockFromCommittedInventory.

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 MutationReleaseInventoryInput! 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 RunReleaseInventory($input: MutationReleaseInventoryInput!) {  releaseInventory(input: $input) {    id    type    delta    createdAt    occurredAt    sku {      id    }    location {      id    }    reason {      name    }  }}

{  "data": {    "releaseInventory": [      {        "id": "ID_VALUE",        "type": "COMMITTED",        "delta": 1,        "createdAt": "2026-01-15T12:00:00.000Z",        "occurredAt": "2026-01-15T12:00:00.000Z",        "sku": {          "id": "SKU_ID"        },        "location": {          "id": "LOCATION_ID"        },        "reason": {          "name": "example-reason"        }      }    ]  }}

Last updated on

releaseInventory

Required headers

Arguments

Possible returns

On this page