Update Budget Modification (Deprecated)
update_budget_modificationUpdate a budget modification in Procore when Budget Changes are disabled, setting transfer amount and target line item.
Instructions
Update a Budget Modification only if Budget Changes are not enabled. This endpoint will be deprecated at October 16th of 2023. For more information on the Budget Changes API, see our documentation on upgrading from the Budget Modifications API to the Budget Changes API. DEPRECATED: Procore has deprecated this endpoint (as of 2022-11-17). It may be removed without further notice; prefer a newer version of this resource where one exists, and use procore_search_endpoints to find it. Send only the fields you intend to change; omitted fields keep their current values. Pass the record's fields as top-level arguments — they are nested under "budget_modification" in the request payload for you. project_id defaults to the value 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 budget modification 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: project_id, id, to_budget_line_item_id, transfer_amount. Procore API: Construction Financials > Budget. Endpoint: PATCH /rest/v1.0/projects/{project_id}/budget_modifications/{id}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | URL path parameter — unique identifier of the Budget resource | |
| notes | No | JSON request body field — notes on the purpose of the transfer | |
| origin_id | No | JSON request body field — the Origin ID to associate with this Budget Modification (must be unique within a company) | |
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| origin_data | No | JSON request body field — the Origin Data to associate with this Budget Modification | |
| transfer_amount | Yes | JSON request body field — the transfer amount for this Budget operation | |
| to_budget_line_item_id | Yes | JSON request body field — iD of the Budget Line Item to transfer to. NOTE: You may not pass the same to_budget_line_item_id as from_budget_line_item_id. | |
| from_budget_line_item_id | No | JSON request body field — iD of the Budget Line Item to transfer from. NOTE 1: required if 'Allow Budget Modifications Which Modify Grand Total' is not checked. NOTE 2: When updating if you want to remove the from_budget_li... |