Skip to main content

Update Purchase Order

PUT 
/api/purchase-orders/:purchase_order

Update an existing purchase order. All fields are optional (sometimes).

Authentication: Requires Bearer token.

Note: Updates acquire a Redis lock to serialize concurrent edits to the same PO. The request blocks for up to 10 seconds waiting for the lock; if the lock still cannot be acquired it returns 409 Conflict.

Update-only fields:

  • po_number: alias for purchase_order_number
  • purchase_order_lines[].id: ID of existing line to update (omit line from array to delete it)
  • financial_lines[].id: ID of existing financial line to update

Cannot reduce line quantity below received or invoiced quantity.

Request​

Responses​

Successful response