Skip to content

Release Reservation

DELETE /inventory/reservations/{id} action bearer

Releases an existing Reservation, returning the quantity to available inventory.

Overview
ID release-reservation-api
Method DELETE
Path /inventory/reservations/{id}
Classification action
Domain inventory
Capability inventory-reservation
Service release-reservation
Application sim — SIM
Auth bearer

Response
Business Object reservation
Description Temporary hold on inventory for a customer, basket, order, or fulfillment flow.
Lifecycle requested → confirmed → fulfilled → expired → cancelled → released

Events Emitted

Event Classification Object Description
inventory-released transitioned reservation A previously reserved quantity was released back to available stock.
reservation-released transitioned reservation An inventory Reservation has been released, restoring available quantity.

Scenarios using inventory-reservation

Scenario Description
Buy Online, Pick Up In Store Customer browses and purchases online, then collects the order from a physical store. The canonical
Exchange Anywhere Customer exchanges an item purchased in any channel at any supported touchpoint. The original item i
Reserve and Collect Customer reserves stock online for in-store collection without paying at the time of reservation. Th
Ship From Store An online order is fulfilled by shipping the goods directly from a physical store rather than a cent
API Method Path Type
Get Inventory GET /inventory/items/{sku} query
Reserve Inventory POST /inventory/reservations command
Confirm Reservation POST /inventory/reservations/{id}/confirm action
Get Stock Locations GET /stock/{sku}/locations query
Check Availability GET /inventory/{sku}/availability query
Allocate Inventory POST /inventory/allocate command