Update Prime Change Order Batch
update_prime_change_order_batchUpdate a prime change order batch by patching only specified fields; omitted fields retain current values. Provide project_id and the batch id to modify.
Instructions
Update the specified Prime Change Order Batch. 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 "change_order_batch" 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 prime change order batch 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. Procore API: Construction Financials > Prime Contracts. Endpoint: PATCH /rest/v1.0/projects/{project_id}/prime_change_order_batches/{id}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | URL path parameter — iD of the Prime Change Order Batch | |
| title | No | JSON request body field — title of the Change Order Batch | |
| number | No | JSON request body field — number of the Change Order Batch | |
| status | No | JSON request body field — the status for this Prime Contracts operation | |
| private | No | JSON request body field — whether or not the Change Order Batch is private | |
| due_date | No | JSON request body field — due date in YYYY-MM-DD format | |
| executed | No | JSON request body field — whether or not the Change Order Batch is executed | |
| form_ids | No | JSON request body field — forms to attach to the response | |
| revision | No | JSON request body field — revision Number | |
| image_ids | No | JSON request body field — images to attach to the response | |
| paid_date | No | JSON request body field — the paid date in YYYY-MM-DD format | |
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| upload_ids | No | JSON request body field — uploads to attach to the response | |
| contract_id | No | JSON request body field — unique identifier for the contract. | |
| description | No | JSON request body field — the description for this Prime Contracts operation | |
| invoiced_date | No | JSON request body field — the invoiced date in YYYY-MM-DD format | |
| attachment_ids | No | JSON request body field — existing attachments to preserve on the response | |
| change_order_ids | No | JSON request body field — array of Change Order (PCO) IDs to link to this batch. This field is only supported for two-tier projects. | |
| file_version_ids | No | JSON request body field — file Versions to attach to the response | |
| legacy_request_ids | No | JSON request body field — array of Change Order Request IDs to link to this batch. This field is only supported for three-tier projects. | |
| signature_required | No | JSON request body field — whether a signature will be required for this Change Order Batch | |
| drawing_revision_ids | No | JSON request body field — drawing Revisions to attach to the response | |
| designated_reviewer_id | No | JSON request body field — unique identifier for the designated reviewer. This field is only supported for single-tier projects. Behavior is undefined in multi-tier projects. | |
| schedule_impact_amount | No | JSON request body field — schedule impact in days | |
| change_event_attachment_ids | No | JSON request body field — list of attachment IDs to attach. These must presently be associated with Change Events. | |
| run_configurable_validations | No | Query string parameter — if true, validations are run for the corresponding Configurable Field Set. | |
| request_for_quote_attachment_ids | No | JSON request body field — list of attachment IDs to attach. These must presently be associated with Request For Quotes (or their Quotes / Responses). | |
| signed_change_order_received_date | No | JSON request body field — signed Change Order Batch Received Date | |
| revised_substantial_completion_date | No | JSON request body field — revised substantial completion date | |
| custom_field_%{custom_field_definition_id} | No | JSON request body field — value of the custom field. The data type of the value passed in corresponds with the data_type of the Custom Field Definition. For a lov_entry data_type the value passed in should be the ID of one ... |