POST /rest/v1.0/projects/{project_id}/instructions

Create a new Instruction associated with the specified Project.

Servers

Path parameters

Name Type Required Description
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
instruction Object Yes
instruction.description String No

The Description of the Instruction

instruction.distribution_member_ids[] Array No

An array of IDs of the Distributions of the Instruction

instruction.number String No

The Number of the Instruction

instruction.upload_ids[] Array No

The specified array of upload ids is saved as Site Instruction Attachments.

instruction.status String Yes

The Status of the Instruction

Possible values:

  • "issued"
  • "draft"
instruction.cost_impact Object No

The Cost Impact of the Instruction

instruction.cost_impact.status String No

The Status of the Cost Impact

Possible values:

  • "no_impact"
  • "n_a"
  • "yes_unknown"
  • "tbd"
  • "yes_known"
instruction.cost_impact.value Number No

Cost impact value in dollars

instruction.date_received String No
instruction.attention_ids[] Array No

An array of IDs of the Attentions of the Instruction

instruction.schedule_impact Object No

The Schedule Impact of the Instruction

instruction.schedule_impact.status String No

The Status of the Schedule Impact

Possible values:

  • "no_impact"
  • "n_a"
  • "yes_unknown"
  • "tbd"
  • "yes_known"
instruction.schedule_impact.value Integer No

The Value in days of the Schedule Impact

instruction.instruction_from_id Integer No

ID of the User who the Instruction is from

instruction.attachments[] Array No

Instruction's 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.

instruction.trade_ids[] Array No

An array of IDs of the Trades of the Instruction

instruction.title String Yes

The Title of the Instruction

instruction.private Boolean No

The Private status of the Instruction

Default value: false

instruction.instruction_type_id Integer Yes

ID of the Instruction Type

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.