Update Custom Field Metadatum
update_custom_field_metadatumUpdate a Procore custom field metadatum by specifying only fields to change; omitted fields keep current values. Resolve the record ID first.
Instructions
Updates an existing custom field metadatum for the specified Procore company. 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 "custom_field_metadatum" in the request payload for you. 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 custom field metadatum 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, custom_field_definition_id, host_type, source_type, source_id, position. Procore API (v2.0): Company Admin > Custom - Configurable Tools. Endpoint: PATCH /rest/v2.0/companies/{company_id}/custom_field_metadata/{id}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | URL path parameter — custom Field Metadatum ID | |
| row | No | JSON request body field — row the Field is position on the Form | |
| view | No | Query string parameter — the extended view provides what is shown below. The default view returns the same as the extended view but excludes the attributes company_id, host_type, source_type, source_id, label, data_type, v... | |
| column | No | JSON request body field — column the Field is position on the Form | |
| visible | No | JSON request body field — whether or not the Custom Field Metadatum is visible | |
| position | Yes | JSON request body field — the position for this Custom - Configurable Tools operation | |
| required | No | JSON request body field — whether or not the Custom Field Metadatum is required | |
| host_type | Yes | JSON request body field — procore Entity | |
| source_id | Yes | JSON request body field — configurable FieldSet ID | |
| company_id | Yes | URL path parameter — unique identifier for the company. | |
| source_type | Yes | JSON request body field — configurable FieldSet Class | |
| column_width | No | JSON request body field — how many columns the field spans on the Form | |
| custom_fields_section_id | No | JSON request body field — custom Fields Section ID | |
| custom_field_definition_id | Yes | JSON request body field — custom Field Definition ID |