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 prevent concurrent edits. Returns 409 Conflict if lock cannot be acquired.

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