Update Submittal Approver
update_submittal_approverUpdate a submittal approver's response, comments, dates, or attachments in Procore. Send only changed fields, providing approver, project, submittal, and response IDs.
Instructions
Update Submittal Approver for the specified Submittal. Send only the fields you intend to change; omitted fields keep their current values. Pass the record's fields as top-level arguments — they are nested under "submittal_approver" in the request payload for you. id must identify an existing parent record — resolve it with the matching list tool first. Returns the modified submittal approver on success. Failures come back as an error payload carrying the HTTP status — commonly 401 when the token has expired, 403 without tool permission, and 404 when an id does not resolve. Required parameters: id, project_id, submittal_id, submittal_response_id. Procore API: Project Management > Submittals. Endpoint: PATCH /rest/v1.0/submittal_approvers/{id}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | URL path parameter — submittal Approver ID | |
| comment | No | JSON request body field — the comment for this Submittals operation | |
| sent_date | No | JSON request body field — parameter is only available to admins. | |
| forward_to | No | JSON request body field — params used only when forwarding for review. Designates who the new reviewer is and what their due date is | |
| project_id | Yes | Query string parameter — unique identifier for the project. | |
| upload_ids | No | JSON request body field — uploads to attach to the response | |
| send_emails | No | Query string parameter — designates whether or not emails will be sent (default false) | |
| submittal_id | Yes | Query string parameter — unique identifier of the submittal | |
| returned_date | No | JSON request body field — parameter is only available to admins. | |
| attachment_ids | No | JSON request body field — submittal Approver's Attachment IDs. The Attachments specified here will be saved as attachments through the request. | |
| attachments_to_upload | No | JSON request body field — submittal Approver'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_t... | |
| submittal_response_id | Yes | JSON request body field — submittal_response_id | |
| associated_attachments | No | JSON request body field — submital Approver's Attachments to be carried forward. The Attachments specified here will be carried forward to the next person in the workflow. |