POST /rest/v1.0/change_events
Create 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
- https://api.procore.com
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 |
|---|---|---|---|
attachments[] |
Array | No |
Change Event Attachments.
To upload attachments you must upload the entire payload as |
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 Possible values:
|
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. Possible values:
|
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[].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[].budget_code |
Object | No |
the Budget Code associated to the Change Event Line Item |
change_event.change_event_line_items_attributes[].budget_code.id |
Integer | No |
ID |
change_event.change_event_line_items_attributes[].cost_code_id |
Integer | No |
Cost Code ID |
change_event.change_event_status_id |
Integer | Yes |
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 Possible values:
|
change_event.attachments_by_uuid[] |
Array | No | |
change_event.attachments_by_uuid[].upload_uuid |
String | No |
UUID |
change_event.event_scope |
String | Yes |
Event Scope Possible values:
|
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 Possible values:
|
change_event.title |
String | No |
Title |
change_event.attachments_by_drawing_revision[] |
Array | No | |
change_event.attachments_by_drawing_revision[].id |
Integer | No |
ID |
How to start integrating
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.