Update Cost Item
update_cost_itemIdempotent
Modify an existing cost catalog record in Procore by updating only the fields you specify. Returns the updated cost item.
Instructions
Update Cost Item. Use this to update an existing Cost Catalog records (only the supplied fields are changed). Updates the specified Cost Catalog records and returns the modified object on success. Required parameters: item_id, company_id, type, name, unit, catalog_id. Procore API (v2.0): Preconstruction > Cost Catalog. Endpoint: PUT /rest/v2.0/companies/{company_id}/estimating/catalogs/items/{item_id}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item_id | Yes | URL path parameter — unique identifier of the item | |
| company_id | Yes | URL path parameter — unique company identifier associated with the Procore User Account. | |
| type | Yes | JSON request body field — the type of the cost item. | |
| name | Yes | JSON request body field — the name of the cost item. | |
| description | No | JSON request body field — the description of the cost item. | |
| unit_cost | No | JSON request body field — the unit cost of the cost item. | |
| unit_labor | No | JSON request body field — the unit labor required for the cost item. | |
| unit_labor_cost | No | JSON request body field — the cost of the unit labor. | |
| manufacturer | No | JSON request body field — the manufacturer of the cost item. | |
| catalog_number | No | JSON request body field — the catalog number of the cost item. | |
| supplier | No | JSON request body field — the supplier of the cost item. | |
| cost_type_code | No | JSON request body field — the cost type code associated with the cost item. Applicable only for items categorized under a Custom cost type. | |
| cost_type_name | No | JSON request body field — the name of the cost type associated with the cost item. Applicable only for items categorized under a Custom cost type. | |
| waste | No | JSON request body field — the waste percentage associated with the cost item. | |
| material_waste | No | JSON request body field — the waste percentage associated with the cost item. | |
| item_margin | No | JSON request body field — the margin applied to the cost item. | |
| labor_margin | No | JSON request body field — the margin applied to the labor for the cost item. | |
| unit_labor_rate | No | JSON request body field — the unit labor rate for the cost item. | |
| is_untaxed | No | JSON request body field — indicates whether the cost item is untaxed. | |
| unit | Yes | JSON request body field — the unit of measurement for the cost item. (17 possible values) | |
| notes | No | JSON request body field — any additional notes about the cost item. | |
| color | No | JSON request body field — the color associated with the cost item. | |
| catalog_id | Yes | JSON request body field — the catalog ID associated with the cost item. | |
| sub_items | No | JSON request body field — array of sub-items associated with the cost item. Ignore unless you are creating an Assembly. |