Modify An Existing Markup
modify_an_existing_markupUpdate an existing markup on a contract or potential change order with new data. Specify holder type, holder ID, and project ID to modify fields such as name, percentage, or position.
Instructions
Modify an existing Markup with new data for specified holder. This endpoint supports the Contract and Potential Change Order tools. Access requires the user to have admin permissions for the relevant tool. Markups associated with contracts can be updated at any time. Markups on potential change orders can only be updated when the SOV (Schedule of Values) lines are in an editable state. Use this to update an existing Contracts (only the supplied fields are changed). Updates the specified Contracts and returns the modified object on success. Required parameters: project_id, holder_type, holder_id, id. Procore API: Construction Financials > Contracts. Endpoint: PATCH /rest/v1.0/financials/markups/{id}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | URL path parameter — unique identifier of the Contracts resource | |
| project_id | Yes | Query string parameter — iD of the Markup's Project | |
| holder_type | Yes | Query string parameter — type of the Markup's Holder | |
| holder_id | Yes | Query string parameter — iD of the Markup's Holder | |
| applies_to_all | No | JSON request body field — indicates if the markup applies to all change management items within the holder. | |
| compound | No | JSON request body field — details of the compound calculations for the markup. | |
| markup_conditions | No | JSON request body field — conditions that determine how the markup will be applied to change management items within the holder. | |
| markup_set | No | JSON request body field — set of the markup. - **Horizontal markup:** Calculates the markup amount on an individual line item. - **Vertical markup:** Calculates the markup amount as a subtotal on all line items on a change ... | |
| name | No | JSON request body field — name of the markup. | |
| percentage | No | JSON request body field — percentage value of the markup. The default precision is 50. | |
| position | No | JSON request body field — position of the markup in the markup set of the holder. The default is the next available position, starting at 1. | |
| prime_line_item_id | No | JSON request body field — unique identifier for the Prime Contract Line Item associated with the markup. This ensures synchronization between the estimated value (without vertical markup) and the revenue value (with verti... | |
| tax_code_ids | No | JSON request body field — list of unique identifiers for tax codes associated with the markup. Applicable only when advanced calculations are enabled. | |
| wbs_code_id | No | JSON request body field — iD of the Wbs Code the Markup percentage will be applied to on a project's budget. Default is ID of the `None` Wbs Code. |