Updates A Material Requirements Document Header.
updates_a_material_requirements_document_headerUpdate header details on a material requirements document, such as title, notes, and status, to move it through workflow states. Send only changed fields.
Instructions
Updates header fields such as title, notes, and status on the material requirements document. Use status transitions to move the document through its workflow states. Send only the fields you intend to change; omitted fields keep their current values. company_id and project_id default to the values 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 material requirements document header 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, company_id, project_id. Procore API (v2.0): Resource Management > Materials Management. Endpoint: PATCH /rest/v2.0/companies/{company_id}/projects/{project_id}/materials_mgmt/material_requirements/{id}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | URL path parameter — the material requirements document ID. | |
| name | No | JSON request body field — name of the document header. | |
| notes | No | JSON request body field — notes associated with the document header. | |
| status | No | JSON request body field — the status for this Materials Management operation | |
| company_id | Yes | URL path parameter — the company identifier | |
| project_id | Yes | URL path parameter — the project identifier | |
| description | No | JSON request body field — description of the document header. | |
| scope_end_at | No | JSON request body field — end date and time for the scope. Clears header field if value is an empty string or "0001-01-01T00:00:00.0000000+00:00". | |
| scope_start_at | No | JSON request body field — start date and time for scope. Clears header field if value is an empty string or "0001-01-01T00:00:00.0000000+00:00". | |
| properties_to_add | No | JSON request body field — collection of resource parameters to add to the document header. | |
| properties_to_delete | No | JSON request body field — collection of resource parameters to delete from the document header. | |
| properties_to_update | No | JSON request body field — collection of resource parameters to update in the document header. | |
| required_on_site_date | No | JSON request body field — date and time by which the item is required to be on site. |