Close And Distribute A Submittal Log
close_and_distribute_a_submittal_logClose a submittal log and distribute it to specified recipients. Set the closed status, add a message, and notify selected users.
Instructions
Close and Distribute the specified Submittal Log. Send only the fields you intend to change; omitted fields keep their current values. project_id defaults to the value set by procore_set_config when omitted, and id must identify an existing parent record — resolve it with the matching list tool first. Returns the modified and distribute a submittal log 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: project_id, id. Procore API: Project Management > Submittals. Endpoint: PATCH /rest/v1.0/projects/{project_id}/submittal_logs/{id}/close_and_distribute
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | URL path parameter — unique identifier of the Submittals resource | |
| message | No | JSON request body field — the message for this Submittals operation | |
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| recipient_ids | No | JSON request body field — loginInformation IDs of users to be notified of the distribution. Available from `GET /rest/v1.0/projects/{project_id}/users`. | |
| prostore_file_ids | No | JSON request body field — prostore File IDs to attach directly to the distribution (e.g., new files uploaded as part of the distribution message). | |
| selected_approvers | No | JSON request body field — the selected approvers for this Submittals operation | |
| submittal_description | No | JSON request body field — submittal_description | |
| submittal_log_status_id | No | JSON request body field — the ID of a Submittal Status (from `GET /rest/v1.0/companies/{company_id}/submittal_statuses`) whose `status` is `Closed`. The Submittal Log will be transitioned to this status as part of the call. | |
| submittal_attachment_ids | No | JSON request body field — submittalAssociatedAttachment IDs to include in the distribution. IDs are resolved by `SubmittalAssociatedAttachment.id`. Available from `GET /rest/v1.0/projects/{project_id}/submittal_logs/{id}`. |