Update A Purchase Order
update_a_purchase_orderUpdate purchase order header fields like title, delivery date, notes, or status. Omitted fields keep current values; returns the updated purchase order.
Instructions
Updates header fields on a purchase order document such as title, delivery date, notes, and status. Use status transitions to move the purchase order through its workflow states. Send only the fields you intend to change; omitted fields keep their current values. company_id and project_id default to the values set by procore_set_config when omitted, and id must identify an existing parent record — resolve it with the matching list tool first. Returns the modified purchase order on success. Failures come back as an error payload carrying the HTTP status — commonly 401 when the token has expired, 403 without tool permission, and 404 when an id does not resolve. Required parameters: id, company_id, project_id. Procore API (v2.0): Resource Management > Materials Management. Endpoint: PATCH /rest/v2.0/companies/{company_id}/projects/{project_id}/materials_mgmt/purchase_orders/{id}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | URL path parameter — unique identifier of the Materials Management resource | |
| name | No | JSON request body field — name of the document header. | |
| notes | No | JSON request body field — notes associated with the document header. | |
| vendor | No | JSON request body field — the vendor for this Materials Management operation | |
| company_id | Yes | URL path parameter — the company identifier | |
| project_id | Yes | URL path parameter — the project identifier | |
| description | No | JSON request body field — description of the document header. | |
| properties_to_add | No | JSON request body field — collection of resource parameters to add to the document header. | |
| properties_to_delete | No | JSON request body field — collection of resource parameters to delete from the document header. | |
| properties_to_update | No | JSON request body field — collection of resource parameters to update in the document header. |