update_submittal
Update submittal details in Procore projects by modifying fields like dates, descriptions, attachments, and status to manage construction documentation.
Instructions
Update Submittal. [Project Management/Submittals] PATCH /rest/v1.0/projects/{project_id}/submittals/{id}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Unique identifier for the project. | |
| id | Yes | Submittal ID | |
| send_emails | No | Designates whether or not emails will be sent (default false) | |
| actual_delivery_date | No | The Actual Delivery Date of the Submittal *This field can only be set if the project has submittal delivery information enabled | |
| attachments | No | Submittal 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. | |
| confirmed_delivery_date | No | The Confirmed Delivery Date of the Submittal *This field can only be set if the project has submittal delivery information enabled | |
| cost_code_id | No | The ID of the Cost Code of the Submittal *This field can only be set by admins | |
| custom_textarea_1 | No | *This field can only be set by admins | |
| custom_textfield_1 | No | *This field can only be set by admins | |
| description | No | The Description of the Submittal | |
| design_team_review_time | No | The Design Team Review Time of the Submittal (in days) *This field can only be set if the project has schedule calculations enabled | |
| distribution_member_ids | No | The IDs of the Distribution Members of the Submittal | |
| due_date | No | The Due Date of the Submittal *This field is not available to be set if sequential approvers is enabled | |
| internal_review_time | No | The Internal Review Time of the Submtital (in days) *This field can only be set if the project has schedule calculations enabled | |
| issue_date | No | The Issue Date of the Submittal *This field can only be set by admins | |
| lead_time | No | The Lead Time of the Submittal (in days) *This field can only be set by admins or if the project has schedule calculations enabled | |
| location_id | No | The Location of the Submittal | |
| number | Yes | The Number of the Submittal | |
| private | No | Whether the Submittal is Private or not | |
| prostore_file_ids | No | An array of Prostore File IDs. The Prostore Files will be associated with the Submittal as attachments. | |
| received_date | No | The Received Date of the Submittal *This field can only be set by admins | |
| received_from_id | No | The Received From of the Submittal | |
| required_on_site_date | No | The Required On Site Date of the Submittal *This field can only be set by admins or if the project has schedule calculations enabled | |
| responsible_contractor_id | No | The Responsible Contractor of the Submittal | |
| revision | No | The Revision of the Submittal | |
| scheduled_task_key | No | The key of the Scheduled Task of the Submittal. Note that use of this parameter is deprecated. Please use `scheduled_task_id` instead. *This field can only be set if the project has submittal deliv... | |
| scheduled_task_id | No | The ID of the Scheduled Task of the Submittal *This field can only be set if the project has submittal delivery information enabled and the user has permissions to view the calendar tool | |
| source_submittal_log_id | No | The ID of the Source Submittal. *By setting this field, the submittal will be created as a revision of source submittal. | |
| specification_section_id | No | The ID of the Specification Section of the Submittal | |
| status_id | No | The ID of the Submittal Status of the Submittal *This field can only be set by admins | |
| sub_job_id | No | The ID of the Sub Job of the Submittal | |
| submit_by | No | The Submit By Date of the Submittal *This field can only be set by admins |