Update Workflow Bulk Replace Request
update_workflow_bulk_replace_requestUpdate existing workflow bulk replace requests by sending only changed fields. Validate and queue async operations, including retrying requests that previously contained errors.
Instructions
Updates an existing workflows bulk replace request. This API validates the input, updates the request record in the DB, and creates a new async operation record. The request must be temporary to be updated. The replacement type and original assignee cannot be changed. This API will queue another async operation even if the update does not introduce any changes, effectively "retrying" a request that previously contained errors. Send only the fields you intend to change; omitted fields keep their current values. company_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 workflow bulk replace request 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: company_id, id. Procore API (v2.0): Core > Workflows. Endpoint: PUT /rest/v2.0/companies/{company_id}/workflows/bulk_replace_requests/{id}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | URL path parameter — unique identifier for the workflow bulk replace request. | |
| tools | No | JSON request body field — array of tool configurations to limit replacement scope (optional) | |
| reason | No | JSON request body field — reason for the replacement | |
| end_date | No | JSON request body field — end date for temporary replacements | |
| company_id | Yes | URL path parameter — unique identifier for the company. | |
| start_date | No | JSON request body field — start date for temporary replacements | |
| project_ids | No | JSON request body field — array of project IDs to limit replacement scope (optional) | |
| new_assignee_ids | No | JSON request body field — array of IDs for new assignees | |
| modify_project_roles | No | JSON request body field — whether to modify project roles during replacement | |
| new_workflow_manager_id | No | JSON request body field — iD of the new workflow manager (optional) |