Update Asset
update_asset_projectPartially update an existing project asset in Procore. Send only fields to change with asset_id, company_id, project_id. Omitted fields stay unchanged. Returns modified asset.
Instructions
Updates the project asset model based on keys in the request body. 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 asset_id must identify an existing parent record — resolve it with the matching list tool first. Returns the modified asset 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: asset_id, company_id, project_id. Procore API (v2.0): Core > Assets. Endpoint: PATCH /rest/v2.0/companies/{company_id}/projects/{project_id}/assets/{asset_id}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | JSON request body field — notes by context. Keys are context identifiers; value is the note text. Supported keys: "asset_status" (stored only when status is changed in this request), "project_assignment" (stored when provid... | |
| asset_id | Yes | URL path parameter — unique identifier for the asset | |
| latitude | No | JSON request body field — latitude must be provided together with longitude, or both must be omitted. Pass null to clear. | |
| trade_id | No | JSON request body field — trade ID. Pass null to clear the value. | |
| longitude | No | JSON request body field — longitude must be provided together with latitude, or both must be omitted. Pass null to clear. | |
| asset_code | No | JSON request body field — unique identifier for the asset (also referred to as asset_code in API) | |
| asset_name | No | JSON request body field — name of the asset | |
| company_id | Yes | URL path parameter — unique identifier for the company. | |
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| description | No | JSON request body field — description of the asset. Pass null to clear the value. | |
| location_id | No | JSON request body field — location ID. Pass null to clear the value. | |
| asset_type_id | No | JSON request body field — asset type ID. Must have Is Asset enabled for that type. If asset type is changed, all custom fields will be reset and only the ones provided in this request will be set. | |
| custom_fields | No | JSON request body field — custom fields map with merge semantics. Key: 'custom\_field\_{id}'. Only fields included in this map will be updated - absent fields remain unchanged. To remove a specific field, set its value to n... | |
| Accept-Language | No | JSON request body field — locale for localized response messages (for example: en, fr-FR, pseudo) | |
| asset_status_id | No | JSON request body field — unique identifier of the asset status | |
| parent_asset_id | No | JSON request body field — parent asset ID. Pass null to remove parent (make standalone). The parent must exist, belong to the same company, and be in the same asset type hierarchy. | |
| profile_image_id | No | JSON request body field — profile image FAS ID. Pass null to clear the value. | |
| cascade_ancestors | No | JSON request body field — when the new parent (or any of its ancestors) is at company scope or on a different project than the child, opt in to cascade-pull those ancestors into the child's project. Defaults to false (retur... | |
| wrap_custom_fields | No | Query string parameter — when true, wraps each custom field value as {"value": ...} and renames "name" to "label" inside LOV objects. | |
| acknowledge_warnings | No | Query string parameter — when true, acknowledges field-default warnings and applies default values for read-only fields whose current value differs from the configured default. |