Skip to main content

Manage Reservations

POST 
/api/sales-order-lines/reservations

Reserve or reverse-reserve inventory for specific sales order lines. Returns the updated sales order.

Authentication: Requires Bearer token.

Body:

  • sales_order_id (required): ID of the parent sales order
  • sales_order_lines (required): Array of line reservation actions
  • sales_order_lines[].id (required): Sales order line ID
  • sales_order_lines[].quantity (required): Quantity to reserve/reverse (> 0, < 100,000)
  • sales_order_lines[].action (required): One of reserve or reverse_reservation

Validation:

  • Returns 422 when a reserve action targets a line where sales_channel_fulfillment_out_of_sync = true. These lines are auto-allocated by the inventory pipeline once stock arrives, so manual reservation is rejected by design. The error key is sales_order_lines.{index}.id.

Request​

Responses​

Successful response