Create asset
create_assetCreate a new asset. Requires assets:write scope. IMPORTANT - Location hierarchy: always resolve top-down by calling list_sites first, then list_buildings filtered by site_id, then list_locations filtered by building_id. Provide all three IDs (site_id, building_id, location_id) explicitly. System hierarchy: similarly resolve via list_system_classes → list_system_groups → list_systems.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Asset name (required) | |
| model | No | Model name/number | |
| site_id | No | Site ID - resolve first via list_sites | |
| asset_id | No | Custom asset identifier (unique per tenant) | |
| quantity | No | Quantity | |
| image_url | No | Image URL | |
| status_id | No | Status ID from list_asset_statuses. The status with system_key archived archives the asset; any other status restores it. | |
| system_id | No | System ID - resolve last via list_systems filtered by system_group_id | |
| meter_unit | No | Meter unit (km, miles, hours, cycles) | |
| building_id | No | Building ID - resolve second via list_buildings filtered by site_id | |
| description | No | Description | |
| location_id | No | Location ID - resolve last via list_locations filtered by building_id | |
| risk_factor | No | Risk factor (CRITICAL, HIGH, MEDIUM, LOW) | |
| asset_type_id | No | Asset type ID (from asset_types) | |
| purchase_cost | No | Purchase cost | |
| purchase_date | No | Purchase date (ISO 8601) | |
| safety_impact | No | Safety impact level (LOW, MEDIUM, HIGH, CRITICAL) | |
| salvage_value | No | Salvage value | |
| serial_number | No | Serial number | |
| cost_per_sq_ft | No | Cost per square foot | |
| service_impact | No | Service impact level (LOW, MEDIUM, HIGH, CRITICAL) | |
| archived_reason | No | Why the asset is archived. Kept only while it is archived. | |
| condition_score | No | Condition score (0-100) | |
| manufacturer_id | No | Manufacturer ID (from manufacturers) | |
| system_class_id | No | System class ID - resolve first via list_system_classes | |
| system_group_id | No | System group ID - resolve second via list_system_groups filtered by system_class_id | |
| unit_of_measure | No | Unit of measure | |
| regulatory_impact | No | Regulatory impact level (LOW, MEDIUM, HIGH, CRITICAL) | |
| replacement_value | No | Cost to replace this asset today, in current dollars. Distinct from purchase_cost, which is what was paid and is the depreciation basis. | |
| reputation_impact | No | Reputation impact level (LOW, MEDIUM, HIGH, CRITICAL) | |
| environmental_impact | No | Environmental impact level (LOW, MEDIUM, HIGH, CRITICAL) | |
| current_meter_reading | No | Current meter/odometer reading | |
| last_maintenance_date | No | Last maintenance date (ISO 8601) | |
| unit_replacement_value | No | Unit replacement value | |
| expected_lifetime_years | No | Expected lifetime in years | |
| salvage_value_percentage | No | Salvage value percentage (0-100) | |
| likelihood_of_failure_score | No | Likelihood of failure score, 1-5. Derived from condition_score unless set: setting it makes it a manual value that condition changes no longer replace; send null to return it to derivation. | |
| consequence_of_failure_score | No | Consequence of failure score, 1-5. Setting it makes it a manual value that a system change no longer replaces; send null to return it to the default from its system. | |
| replacement_value_reviewed_on | No | Date replacement_value was last confirmed (ISO 8601) |