PATCH /rest/v1.0/change_events/{id}

Update Change Event. Note: A budget line item will automatically be created for Non-budgeted line items for all new projects and for projects enabled with Non-Budgeted line item beta functionality

Servers

Path parameters

Name Type Required Description
id Integer Yes

ID

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Procore-Company-Id Integer Yes

Unique company identifier associated with the Procore User Account.

Query parameters

Name Type Required Description
project_id Integer Yes

Unique identifier for the project.

Request body fields

Name Type Required Description
change_event_origin_type String No

Change Event origin type. Supported values: GenericToolItem, CommunicationThread, Meeting, Observations::Item, Rfi::Header, SiteInstruction.

project_id Integer Yes

Unique identifier for the project.

origin_global_id String No

Global ID of the record to associate as the Change Event origin. Provide instead of change_event_origin_id and change_event_origin_type.

attachments[] Array No

Change Event Attachments. To upload attachments you must upload the entire payload as multipart/form-data content-type and specify each parameter as form-data together with attachments[] as files.

change_event Object Yes
change_event.change_event_line_items_attributes[] Array No

Change Event Line Items

change_event.change_event_line_items_attributes[].proposed_vendor_id Integer No

Proposed Vendor ID

change_event.change_event_line_items_attributes[].line_item_type_id Integer No

Line Item Type ID

change_event.change_event_line_items_attributes[].estimated_cost_unit_cost Number No

Estimated Cost Unit Cost

change_event.change_event_line_items_attributes[].description String No

Description

change_event.change_event_line_items_attributes[].uom String No

Unit of Measure

Valid values:

  • "Any value present in the Company list of Units of Measure"
change_event.change_event_line_items_attributes[].estimated_cost_calculation_strategy String No

Estimated Cost Calculation Strategy. Controls whether estimated_cost_amount is calculated from the quantity and unit_cost attributes or set manually to a provided value.

Valid values:

  • "manual"
  • "automatic"
change_event.change_event_line_items_attributes[].estimated_cost_amount Number No

Estimated Cost Amount

change_event.change_event_line_items_attributes[].commitment_contract_line_item_id Integer No

Commitment Contract Line Item ID

change_event.change_event_line_items_attributes[].id Integer No

ID

change_event.change_event_line_items_attributes[].wbs_code_id Object No

the WBS (Budget) Code associated to the Change Event Line Item

change_event.change_event_line_items_attributes[].wbs_code_id.id Integer No

ID

change_event.change_event_line_items_attributes[].estimated_cost_quantity Number No

Estimated Cost Quantity

change_event.change_event_line_items_attributes[].proposed_contract_id Integer No

Proposed Contract ID

change_event.change_event_line_items_attributes[].cost_code_id Integer No

Cost Code ID

change_event.change_event_status_id Integer No

Change Event Status ID

change_event.change_order_change_reason_id Integer No

Change Order Change Reason ID

change_event.number String No

Number

change_event.attachments_by_image[] Array No
change_event.attachments_by_image[].id Integer No

ID

change_event.status String No

DEPRECATED: Use :change_event_status_id. Status

Valid values:

  • "open"
  • "closed"
change_event.attachments_by_uuid[] Array No
change_event.attachments_by_uuid[].upload_uuid String No

UUID

change_event.event_scope String No

Event Scope

Valid values:

  • "tbd"
  • "out_of_scope"
  • "in_scope"
change_event.attachments_by_file_version[] Array No
change_event.attachments_by_file_version[].id Integer No

ID

change_event.origin_data String No

Origin data

change_event.rfi_id Integer No

RFI ID

change_event.attachments_by_form[] Array No
change_event.attachments_by_form[].id Integer No

ID

change_event.origin_id String No

Origin ID

change_event.event_type String No

Event Type

Valid values:

  • "contingency"
  • "transfer"
  • "tbd"
  • "allowance"
  • "owner_change"
change_event.title String No

Title

change_event.attachments_by_drawing_revision[] Array No
change_event.attachments_by_drawing_revision[].id Integer No

ID

change_event_origin_id Integer No

ID of the record to associate as the Change Event origin. Provide alongside change_event_origin_type. Send both values as null to remove an existing origin.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.