POST /rest/v1.0/task_items

Creates a task item on a given project

Servers

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
task_item Object Yes
task_item.file_version_ids[] Array No

File Versions to attach to the response

task_item.prostore_file_ids[] Array No

Prostore File IDs

task_item.description String No

Description

task_item.distribution_member_ids[] Array No

Distribution Member IDs

task_item.image_ids[] Array No

Images to attach to the response

task_item.document_management_document_revision_ids[] Array No

PDM document to attach to the response

task_item.number String No

Number

task_item.upload_ids[] Array No

Uploads to attach to the response

task_item.status String No

Status

Possible values:

  • "in_progress"
  • "ready_for_review"
  • "initiated"
  • "closed"
  • "void"
task_item.assignee_ids[] Array No

Assignee IDs

task_item.drawing_revision_ids[] Array No

Drawing Revisions to attach to the response

task_item.task_item_category_id Integer No

The task item category to associate with the task item.

task_item.assigned_id Integer No

Assignee ID

task_item.form_ids[] Array No

Forms to attach to the response

task_item.attachments[] Array No

Task 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.

task_item.title String No

Title

task_item.private Boolean No

Privacy flag

task_item.due_date String No

Date and time due

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.