Update Asset
update_asset_companyUpdate a company asset's details in Procore by sending only the fields you want to change; omitted fields retain their current values. Returns the modified asset.
Instructions
Updates the company 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 defaults to the value 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. Procore API (v2.0): Core > Assets. Endpoint: PATCH /rest/v2.0/companies/{company_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. | |
| 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. |