PATCH /rest/v2.0/companies/{company_id}/projects/{project_id}/estimating/proposals/{proposal_id}/line_items/{line_item_id}

Update an estimate line item of the proposal

Servers

Path parameters

Name Type Required Description
proposal_id String Yes

Proposal Id

project_id String Yes

Unique project identifier

company_id String Yes

Unique company identifier associated with the Procore User Account.

line_item_id String Yes

Line Item 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.

Request body fields

Name Type Required Description
name Object No

Display name of the line item.

group_id Object No

Line item group ID.

cost_item Object No

Cost item fields to update. Only provided fields will be updated. Omit to leave unchanged. If the line item has no existing cost item, a new one will be created. Cost item cannot be removed.

cost_item.description Object No

Description of the cost item.

cost_item.unit_labor_rate Object No

Labor rate per unit.

cost_item.catalog_id Object No

Catalog folder ID.

cost_item.unit_labor Object No

Labor time per unit, in the unit specified by labor_time_unit.

cost_item.unit_cost Object No

Unit material cost.

cost_item.labor_time_unit Object No

Unit for labor time. Allowed: Minutes, Hours, Days, Weeks, Months.

cost_item.unit Object No

Unit of measurement. Allowed: Ea, Ft, SqFt, CuFt, Gal, Lb, Yd, SqYd, CuYd, Square, None, Minutes, Hours, Days, Ton, Weeks, Months, LumpSum.

cost_item.id Object No

Catalog or cost item ID. Use empty string or "-1" for new custom items.

cost_item.delivery_unit Object No

Delivery unit quantity.

cost_item.manufacturer Object No

Manufacturer of the item.

cost_item.type Object No

Cost item category. Allowed: Part, Assembly, Custom, Equipment, Subcontractor, Travel, Labor.

cost_item.supplier Object No

Supplier or vendor name.

cost_item.is_untaxed Object No

Whether the item is excluded from tax.

cost_item.unit_labor_cost Object No

Unit labor cost.

cost_item.url Object No

URL to product or specification.

cost_item.based_on_item_id Object No

ID of the catalog item this cost item is based on.

cost_item.material_waste Object No

Material waste percentage.

cost_item.symbol_id Object No

Symbol ID for takeoff. Built-in: circle, square, empty. Custom: numeric document ID string.

cost_item.name Object No

Display name of the cost item.

cost_item.notes Object No

Notes.

cost_item.waste Object No

Waste percentage.

cost_item.labor_margin Object No

Labor margin percentage.

cost_item.catalog_number Object No

Catalog or product number.

cost_item.item_margin Object No

Item margin percentage.

cost_item.color Object No

Display color. Example: "#00ecff".

tag Object No

Optional tag for filtering or grouping.

labor_factor Object No

Labor difficulty factor applied to the cost item.

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.