Update purchase order item

Updates a purchase order item's name, sequence, or percentage. The item amount is automatically recalculated when the percentage changes.

Important Notes

  • Changing the percentage will trigger automatic recalculation of the item amount
  • The total of all item percentages must still sum to 100% after the update
  • Items can only be updated if the purchase order is not in completed status
  • For ByMilestone type purchase orders, the name field is required
  • The sequence must remain unique within the purchase order

Authorization

  • User must be a member of the company that owns the purchase order
  • User must have appropriate permissions (admin, owner, or member)

Use Cases

  1. Adjust percentages: Rebalance payment stages
  2. Update item names: Clarify milestone descriptions
  3. Reorder items: Change sequence numbers
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

ID of the purchase order

uuid
required

ID of the item to update

Body Params

Updated item details

item
object
Headers
uuid
required

UUID of the company on whose behalf the request is made. Required for every Pay endpoint. See The company-id header for details on how to obtain a value for this header and the error responses to expect when it is missing or invalid.

If the deprecated company_id query parameter is also sent, both values must match; the API returns 422 Unprocessable Entity when they disagree.

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json