PATCH /rest/v1.1/projects/{project_id}/direct_costs/{id}

Update a specific Direct Cost Item. The number of Line Items that can be sent in a single update request is limited to 100. This action does not support concurrent requests. If there is an attempt to update a Direct Cost that is being updated or deleted by another request, a 409 Conflict error will be returned.

Servers

Path parameters

Name Type Required Description
id Integer Yes

ID

project_id Integer Yes

Unique identifier for the project.

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
direct_cost Object No

Direct Cost Item object

direct_cost.vendor_id Integer No

Vendor ID

direct_cost.description String No

Description

direct_cost.line_items[] Array No

Line items that should be assoicated with the direct cost item.

direct_cost.line_items[].id Integer No

ID of the line item (only required when updating)

direct_cost.line_items[].manual_amount Number No

Amount

direct_cost.line_items[].direct_cost_id Integer No

Direct Cost ID

direct_cost.line_items[].description String No

Description

direct_cost.line_items[].wbs_code_id Integer No

WBS Code ID (required when creating new line items on the direct cost)

direct_cost.line_items[].origin_id String No

Origin ID

direct_cost.line_items[].quantity Number No

Quantity of described item

direct_cost.line_items[].ref String No

The reference, if any, passed in upon item creation and is not persisted.

direct_cost.line_items[].uom String No

Unit of measure of the described item

Possible values:

  • "Any value present in the Company list of Units of Measure"
direct_cost.line_items[].unit_cost Number No

Unit cost of described item

direct_cost.line_items[].origin_data String No

Origin Data

direct_cost.payment_date String No

Payment Date

direct_cost.origin_id String No

Origin ID

direct_cost.received_date String No

Received Date

direct_cost.employee_id Integer No

Employee ID tied to the Direct Cost Item

direct_cost.direct_cost_date String No

Date

direct_cost.status String No

Status

Possible values:

  • "approved"
  • "pending"
  • "revise_and_resubmit"
  • "draft"
direct_cost.origin_data String No

Origin Data

direct_cost.terms String No

The agreed upon Terms for the date of payment

attachments[] Array No

Direct Cost Item 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.

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.