AssetLab

Create an attachment record linked to a work order, work request, PM schedule, or PM template. Exactly one parent ID must be provided. Requires attachments:write scope.

Set an annual funding budget, as the dashboard Budget tab does. Requires budgets:write scope. The tab holds one figure per year, per funding source ('O&M' or 'Capital'), per workspace (module: facilities, infrastructure, or omitted for organization-wide). Send one row per year and funding source - do not split a year across sites or buildings; the tab does not read site_id or building_id and a second row for the same slot is refused with 409. Required: year, funding_source, budgeted_amount.

Create a new building. Requires buildings:write scope. latitude and longitude place the building on the map and must be sent together - one without the other is rejected.

Create a new building type. Requires building_types:write scope.

Create a new change order. Requires change_orders:write scope.

Create a new compliance item (regulatory requirement). Requires compliance:write scope.

Link a PM schedule to a compliance item, so completing the schedule keeps the item compliant. Requires compliance:write scope. Required: compliance_item_id, pm_schedule_id, required_frequency_days. Resolve both ids first with list_compliance_items and list_pm_schedules.

Create a new compliance record (audit trail entry). Requires compliance_records:write scope.

Create a new contract. Requires contracts:write scope.

Create a contract document record. Requires contract_documents:write scope.

Assign a contract to a site. Requires contract_sites:write scope.

Create a new cost category. Requires cost_categories:write scope.

Override the criticality modifier for one tier. Rows are overrides only: a tier with no row uses the built-in default (critical 0.6, high 0.8, medium 1.0, low 1.4). A modifier below 1 tightens every target held by facilities in that tier and one above 1 relaxes them. One override per tier; a duplicate returns 409, so call list_criticality_modifiers and update the existing row instead. Requires los_targets:write scope.

Create a new custom field definition. Requires custom_fields:write scope.

Create (upsert) a custom field value for an entity. The table stores values in typed columns - prefer setting the one that matches the field definition's field_type: value_text (text/select; a select value must be one of the field's options), value_number (number), value_date (date, ISO YYYY-MM-DD), value_boolean (boolean). Alternatively pass a single `value` string and the server will dispatch it to the right column based on field_type. Writes upsert on (entity_id, field_definition_id) so replaying a batch is idempotent. Requires custom_fields:write scope.

Create a new expense. Requires expenses:write scope.

Create a floorplan row. Provide EXACTLY ONE of building_id (per-building floor) or site_id (site-level / campus plan). Typically the web app calls this per page of an uploaded PDF; MCP clients rarely need to call this directly since they do not upload the PDF itself. Requires floorplans:write scope.

Create a region (labeled room or zone) on a floorplan. Polygon coordinates are normalized 0-1 with origin top-left. Optionally link the region to an existing Location via location_id. Requires floorplan_regions:write scope.

Attach a published form to one record so it can be filled in - the direct way to put an inspection or checklist on an existing work order. The form's questions are snapshotted at attach time, so later edits to the template never change a form already in progress. To put a form on every work order a PM schedule generates, set form_template_id on the schedule instead of calling this per work order. Answering and completing the form happen in the AssetLab app, not through this API. Requires form_responses:write scope.

Create a form template - a reusable inspection, checklist, compliance, or survey definition. Step 1 of building a form: create it as a draft, then add questions with create_form_template_item (or bulk_create on form-template-items), then publish with update_form_template status=published (publishing is rejected if any question is malformed). Requires form_templates:write scope.

Add one question (item) to a form template. Build a form by calling this once per question in order, or use bulk_create on form-template-items. Requires form_template_items:write scope.

Create an infrastructure asset (feature - segment or node). Geometry must be GeoJSON Point (for nodes) or LineString (for segments) in EPSG:4326; coordinates are [longitude, latitude]. `length_m`, `slope_pct`, and `risk_score` are computed server-side. Requires infrastructure_assets:write scope.

Add a comment to an infrastructure feature. The author is attributed to the API key automatically; do not pass user_id. Requires infrastructure_asset_comments:write scope.

Record a cost against an infrastructure feature. work_order_number is derived server-side from work_order_id; do not set it. Requires infrastructure_asset_costs:write scope.

Attach document metadata to an infrastructure feature. Upload the file bytes first via create_upload_url, then pass the returned file_path here. Requires infrastructure_asset_documents:write scope.

Record an inspection against an infrastructure feature. Requires infrastructure_asset_inspections:write scope.

Associate a part with an infrastructure feature. The (feature_id, part_id) pair must be unique - a duplicate returns 409. Requires infrastructure_asset_parts:write scope.

Create a tenant-defined infrastructure feature class. Builtin classes are managed by AssetLab and cannot be created via API (is_builtin is always forced to false). Requires infrastructure_feature_classes:write scope.

Create a lifecycle strategy event. Events attach to a SCOPE (feature_class code, material, optional diameter band) - never to individual features; every feature resolves the most specific matching scope, like replacement rates. Replacement is NOT an event (it is priced by the rates and scheduled by the renewal forecast) - model the interventions BEFORE replacement: crack sealing, relining, resurfacing. List existing events first to reuse a scope. Requires infrastructure_lifecycle_events:write scope.

Set the technical Level of Service target for one infrastructure feature class and metric. One base target per feature class and metric, set once for the organization; a duplicate returns 409, so update the existing row instead. Each network of that class is held to a version adjusted by the network's criticality (unrated counts as medium): a lower-is-better target is multiplied by the tier's modifier, a higher-is-better one keeps its distance from a perfect score multiplied by it (condition 70 becomes 82 at a Critical network, 58 at a Low one). Derived targets never leave the metric's scale. …

Create an infrastructure network - a named grouping of features bound to one feature class. Requires infrastructure_networks:write scope.

Create an operational hydraulic boundary (pressure zone, DMA, sewershed, etc.). boundary is a GeoJSON Polygon, or a MultiPolygon when the area comes in separate pieces. (network_id, name) must be unique. Requires infrastructure_zones:write scope.

Create a new invoice. Requires invoices:write scope.

Create a new location within a building. Requires locations:write scope.

Create a new location type. Requires location_types:write scope.

Record what a missed technical Level of Service target means, in the organization's own words. Advisory only: the statement is shown on the Status screen when a matching target is breached, and no notification is sent to notify_roles or to anyone else. When several match a breach the most specific scope wins (a specific system or feature class over a criticality tier over global). severity is a floor; the severity shown scales with the size of the gap and the facility's criticality. Requires los_consequences:write scope.

Create a new LoS measure within a service area. Requires los_measures:write scope. Resolve service_area_id first via list_service_areas.

Record a new LoS measurement value. Requires los_measurements:write scope. Resolve los_measure_id first via list_los_measures.

Record the proposed level of service for a LoS measure in one future year (O. Reg. 588/17 s. 6(1)). One row per measure and year; a duplicate returns 409, so update the existing row instead. Use target_statement for a community measure and target_value for a technical one. Requires los_proposed_targets:write scope. Resolve los_measure_id first via list_los_measures.

Create a new manufacturer. Requires manufacturers:write scope.

Create a new part/inventory item. Requires parts:write scope.

Create a new part category. Requires part_categories:write scope.

Create a new preventive maintenance schedule. Requires pm_schedules: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 explicitly.

Create a new PM template. Templates are reusable PM definitions (not linked to a site/asset) that can seed new PM schedules. Requires pm_templates:write scope.

Create a new project. Requires projects:write scope.

Link an asset to a project. Requires project_assets:write scope.

Create a new project budget item. Requires project_budget_items:write scope.

Link a building to a project. Requires project_buildings:write scope.

Create a new comment on a project. Requires project_comments:write scope.

Record a cost snapshot for a project at a point in time. Requires project_cost_snapshots:write scope.

Create a project document record. Requires project_documents:write scope.

Create a project document folder template. Requires project_document_folder_templates:write scope.

Link a project to an infrastructure feature. The (project_id, feature_id) pair must be unique - a duplicate returns 409. Requires project_infrastructure_assets:write scope.

Link a location to a project. Requires project_locations:write scope.

Create a new project milestone. Requires project_milestones:write scope.

Create a new project phase. Requires project_phases:write scope.

Create a new project phase category. Requires project_phase_categories:write scope.

Create a new project risk. Requires project_risks:write scope.

Link a site to a project. Requires project_sites:write scope.

Link a system to a project. Requires project_systems:write scope.

Link a system class to a project. Requires project_system_classes:write scope.

Link a system group to a project. Requires project_system_groups:write scope.

Create a new project task. Requires project_tasks:write scope.

Create a dependency between two project tasks. Requires project_task_dependencies:write scope.

Add a team member to a project. Requires project_team_members:write scope.

Create a new project time entry. Requires project_time_entries:write scope.

Create a periodic project status update. Requires project_updates:write scope.

Create a new purchase order. Requires purchase_orders:write scope.

Add a line item to a purchase order. Requires purchase_orders:write scope. The PO's amount becomes the sum of its lines. A line naming a part_id is counted in whole units, and its quantity_received is added to that part's stock. Required: purchase_order_id, description, quantity.

Link a purchase order to a work order, PM schedule or project for reference. Requires purchase_orders:write scope. Required: purchase_order_id and exactly one of work_order_id, pm_schedule_id, project_id. A link does not add to committed cost; to charge the cost, set project_id or work_order_id on the purchase order itself.

Create a new service area for Level of Service tracking. Requires service_areas:write scope. After creating, link system classes via create_service_area_system_class and sites via create_service_area_site.

Link a site to a service area (optional scoping). Requires service_areas:write scope. Resolve IDs first: list_service_areas → service_area_id, list_sites → site_id.

Link a system class to a service area. Requires service_areas:write scope. Resolve IDs first: list_service_areas → service_area_id, list_system_classes → system_class_id.

Create a new site. Requires sites:write scope.

Create a new system. Requires systems:write scope.

Create a new system class (top-level classification, e.g., "HVAC & Mechanical", "Material Handling"). Requires systems:write scope.

Create a new system group (category under a system class, e.g., "Heating", "Cooling"). Requires systems:write scope.

Set the technical Level of Service target for one system and metric. One base target per system and metric, set once for the organization; a duplicate returns 409, so update the existing row instead. Each building is held to a version adjusted by its criticality: a lower-is-better target is multiplied by the tier's modifier, a higher-is-better one keeps its distance from a perfect score multiplied by it (condition 70 becomes 82 at a Critical facility, 58 at a Low one). Derived targets never leave the metric's scale. Direction is fixed by the metric and cannot be sent: asset_condition_avg is hi…

Generate a signed upload URL for uploading a file to AssetLab storage. Returns a signed_url to PUT the file to, and the storage path to store on the record. IMPORTANT - When a user wants to upload a file, always clarify the target. File upload paths: (1) Asset IMAGE: bucket "asset-images" → update_asset with image_url. (2) Asset DOCUMENT (O&M, warranty, spec): bucket "documents" → create_asset_document. (3) Work order IMAGE: bucket "attachments" → update_work_order with image_url. (4) Work order/request/PM ATTACHMENT: bucket "attachments" → create_attachment with the parent ID. (5) Project DOC…

Create a new vendor. Requires vendors:write scope.

Assign a vendor to a site. Requires vendor_site_assignments:write scope.

Create a new work category. Requires work_categories:write scope.

Create a new work order. Requires work_orders:write scope. REQUIRED: title. STRONGLY RECOMMENDED: site_id, building_id and at least one target (asset_id, location_id, system_ids or infrastructure_asset_ids) - the AssetLab app always sets one, and a work order with no target is hard to find and to cost, so ask the user which applies before calling. The API accepts a work order without a target. Also recommended: work_category_id (look up via list_work_categories; omit only if no reasonable match exists). Location hierarchy: always resolve top-down by calling list_sites first, then list_building…

Create a new comment on a work order. Requires work_order_comments:write scope.

Schedule a work order for a technician on a date (one entry of a day plan). stop_order gives the position in the technician's day; leave it unset for an unordered calendar entry. Requires work_order_schedules:write scope.

Create a new work request. Requires work_requests: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.

Permanently delete an asset by ID, cascading to its history. Requires assets:write scope. For an asset taken out of service, archive it instead with update_asset (status_id = the Archived status), which keeps its work orders, costs and inspections.

Delete a betterment by ID. The asset's net book value and remaining life revert to what they were without it. Requires asset_betterments:write scope.

Delete an asset comment by ID. Requires asset_comments:write scope.

Soft-delete an asset condition assessment by ID. Requires asset_condition_assessments:write scope.

Delete an asset cost entry by ID. Requires asset_costs:write scope.

Delete an asset document by ID. Requires asset_documents:write scope.

Delete a facility lifecycle strategy event by ID. Projections recompute immediately; consider update with is_active=false to disable instead. Requires asset_lifecycle_events:write scope.

Remove a part from an asset by association ID. Requires asset_parts:write scope.

Remove an asset placement. The asset itself is not affected - only the pin on the floorplan is removed. Requires asset_placements:write scope.

Delete an asset replacement plan by ID. Requires asset_replacement_plans:write scope.

Delete an asset status by ID. Requires asset_statuses:write scope. The built-in Archived status (system_key archived) cannot be deleted.

Delete an asset type by ID. Requires asset_types:write scope.

Delete an asset type group by ID. Requires asset_type_groups:write scope.

Delete an attachment by ID. Requires attachments:write scope.

Delete a budget by ID. Requires budgets:write scope.

Delete a building by ID. Requires buildings:write scope.

Delete a building type by ID. Requires building_types:write scope.

Delete a change order by ID. Requires change_orders:write scope.

Delete a compliance item by ID. Requires compliance:write scope.

Unlink a PM schedule from a compliance item. The schedule and the item both stay. Requires compliance:write scope.

Delete a compliance record by ID. Requires compliance_records:write scope.

Delete a contract by ID. Requires contracts:write scope.

Delete a contract document by ID. Requires contract_documents:write scope.

Remove a contract from a site. Requires contract_sites:write scope. An assignment is identified by its contract and site; it has no id of its own.

Delete a cost category by ID. Requires cost_categories:write scope.

Delete a criticality modifier override by ID, which restores the built-in default for that tier (critical 0.6, high 0.8, medium 1.0, low 1.4). Requires los_targets:write scope.

Delete a custom field definition by ID. Requires custom_fields:write scope.

Delete a custom field value by ID. Requires custom_fields:write scope.

Delete an expense by ID. Requires expenses:write scope.

Delete a floorplan. WARNING: cascades to all regions and asset placements on this floor. Does NOT delete the underlying PDF file from storage (do that separately if no other floors reference it). Requires floorplans:write scope.

Delete a region. Asset placements that referenced this region will have region_id set to null but remain on the floorplan. Requires floorplan_regions:write scope.

Remove a form from the record it is attached to, along with any answers already given. Use this before attaching a different form, since a record holds at most one form. Requires form_responses:write scope.

Delete a form template by ID. Requires form_templates:write scope.

Delete a form template item by ID. Requires form_template_items:write scope.

Soft-delete an infrastructure asset (feature) by ID (sets deleted_at). Requires infrastructure_assets:write scope.

Delete an infrastructure asset comment by ID. Requires infrastructure_asset_comments:write scope.

Delete an infrastructure asset cost by ID. Requires infrastructure_asset_costs:write scope.

Delete an infrastructure asset document by ID. Requires infrastructure_asset_documents:write scope.

Soft-delete an infrastructure asset inspection by ID. Requires infrastructure_asset_inspections:write scope.

Delete an infrastructure asset part association by ID. Requires infrastructure_asset_parts:write scope.

Delete a tenant-defined infrastructure feature class by code. Builtin classes cannot be deleted. Classes referenced by any infrastructure network are protected by FK and cannot be deleted until those networks are reassigned. Requires infrastructure_feature_classes:write scope.

Delete a lifecycle strategy event by ID. Projections recompute immediately; consider update with is_active=false to disable instead. Requires infrastructure_lifecycle_events:write scope.

Delete an infrastructure LoS target by ID. Networks of that class stop being scored on the metric; past status snapshots are kept. Requires los_targets:write scope.

Delete an infrastructure network by ID. Cascades to all features in the network - confirm with the user before deleting. Requires infrastructure_networks:write scope.

Delete an infrastructure zone by ID. Requires infrastructure_zones:write scope.

Delete an invoice by ID. Requires invoices:write scope.

Delete a location by ID. Requires locations:write scope.

Delete a location type by ID. Requires location_types:write scope.

Delete a LoS consequence by ID. Requires los_consequences:write scope.

Delete a LoS measure by ID. WARNING: This also deletes all associated measurements and targets history. Requires los_measures:write scope.

Delete a LoS measurement by ID. Requires los_measurements:write scope.

Delete a LoS proposed target by ID. Requires los_proposed_targets:write scope.

Delete a manufacturer by ID. Requires manufacturers:write scope.

Delete a part/inventory item by ID. Requires parts:write scope.

Delete a part category by ID. Requires part_categories:write scope.

Delete a PM schedule by ID. Requires pm_schedules:write scope.

Delete a PM template by ID. Requires pm_templates:write scope.

Delete a project by ID. Requires projects:write scope.

Remove an asset from a project by ID. Requires project_assets:write scope.

Delete a project budget item by ID. Requires project_budget_items:write scope.

Remove a building from a project by ID. Requires project_buildings:write scope.

Delete a project comment by ID. Requires project_comments:write scope.

Delete a project cost snapshot by ID. Requires project_cost_snapshots:write scope.

Delete a project document by ID. Requires project_documents:write scope.

Delete a project document folder template by ID. Requires project_document_folder_templates:write scope.

Delete a project ↔ infrastructure feature link by ID. Requires project_infrastructure_assets:write scope.

Remove a location from a project by ID. Requires project_locations:write scope.

Delete a project milestone by ID. Requires project_milestones:write scope.

Delete a project phase by ID. Requires project_phases:write scope.

Delete a project phase category by ID. Requires project_phase_categories:write scope.

Delete a project risk by ID. Requires project_risks:write scope.

Remove a site from a project by ID. Requires project_sites:write scope.

Remove a system from a project by ID. Requires project_systems:write scope.

Remove a system class from a project by ID. Requires project_system_classes:write scope.

Remove a system group from a project by ID. Requires project_system_groups:write scope.

Delete a project task by ID. Requires project_tasks:write scope.

Delete a task dependency by ID. Requires project_task_dependencies:write scope.

Remove a team member from a project by ID. Requires project_team_members:write scope.

Delete a project time entry by ID. Requires project_time_entries:write scope.

Delete a project update by ID. Requires project_updates:write scope.

Delete a purchase order by ID. Requires purchase_orders:write scope.

Delete a purchase order line item. Requires purchase_orders:write scope. A line with stock received is refused until its quantity_received is set back to 0.

Remove a purchase order link. Requires purchase_orders:write scope.

Delete a service area by ID. WARNING: This also deletes all linked measures, measurements, and junction records. Requires service_areas:write scope.

Remove a site link from a service area. Requires service_areas:write scope.

Remove a system class link from a service area. Requires service_areas:write scope.

Delete a site by ID. Requires sites:write scope.

Delete a system by ID. Requires systems:write scope.

Delete a system class by ID. Requires systems:write scope.

Delete a system group by ID. Requires systems:write scope.

Delete a system LoS target by ID. Buildings stop being scored on that system and metric; past status snapshots are kept. Requires los_targets:write scope.

Delete a vendor by ID. Requires vendors:write scope.

Remove a vendor-site assignment by ID. Requires vendor_site_assignments:write scope.

Delete a work category by ID. Requires work_categories:write scope.

Delete a work order by ID. Requires work_orders:write scope.

Delete a work order comment by ID. Requires work_order_comments:write scope.

Delete a work order schedule entry by ID (removes the stop from the technician's day). Requires work_order_schedules:write scope.

Delete a work request by ID. Requires work_requests:write scope.

Get detailed information about a specific asset by its ID, archived or not; archived_at is set on an archived asset. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single betterment by ID - one capital improvement on one asset, with its cost, the service life it bought, and its in-service date. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single asset comment by ID.

Get a single asset condition assessment by ID. Condition scores are 0-100: 85+ Excellent, 70-84 Good, 55-69 Fair, 40-54 Poor, below 40 Critical. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single asset cost record by ID - the record type shown on the main AssetLab "Expenses" page. Returns amount, cost_date, category, description, invoice_number, po_number, and related asset, site, building, and work_order. Distinct from get_expense (project-scoped expenses without invoice/PO). Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single asset document by ID.

Get a single facility lifecycle strategy event by ID. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single asset-part association by ID, including asset and part details.

Get a single asset placement by ID.

Get a single asset replacement plan by ID. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single asset risk history entry by ID.

Get a single asset status by ID.

Get a single attachment by ID.

Get a single annual funding budget by ID. Use list_sites/list_buildings to resolve site_id/building_id. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a change order by ID, including amount, status, vendor, and linked project. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get detailed compliance item including linked PM schedules and their required frequencies.

Get one compliance item to PM schedule link by its ID.

Get a single compliance record by ID.

Get a single contract document by ID.

Get a single criticality modifier override by ID. A tier with no override uses the built-in default (critical 0.6, high 0.8, medium 1.0, low 1.4); a modifier below 1 tightens targets and one above 1 relaxes them.

Get a single custom field definition by ID.

Get a single custom field value by ID.

Get a single dashboard snapshot by ID. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get aggregated dashboard statistics: total assets, work orders by status, overdue count, active PM schedules, sites, and buildings.

Get a project-scoped expense (Project → Costs → Expenses tab) by ID, including amount, date, receipt, and linked project or work order. Does NOT include invoice_number or po_number - those live on asset_costs (the main AssetLab "Expenses" page). Use get_asset_cost for that record type. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single floorplan by ID. Returns floor metadata, PDF path, page number, and detection status.

Get a single floorplan region by ID.

Get detailed information about a specific form response by its ID.

Get detailed information about a specific form response answer by its ID.

Get detailed information about a specific form template by its ID.

Get detailed information about a specific form template item by its ID.

Get a single infrastructure asset (feature) by ID. Returns full geometry as GeoJSON plus all attributes. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single infrastructure asset comment by ID.

Get a single infrastructure asset cost by ID. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single infrastructure asset document by ID.

Get a single infrastructure asset inspection by ID.

Get a single infrastructure asset part association by ID.

Get a single infrastructure asset risk history entry by ID. Read-only.

Get a single infrastructure feature class by its `code` (e.g. "water_main"). Note: addressed by code, not UUID.

Get a single lifecycle strategy event by ID. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single infrastructure LoS target by ID. base_target is the base for that feature class and metric, not what any one network is held to (list_infrastructure_los_targets explains the criticality adjustment). All three metrics are 0-100; condition is higher-is-better, fci and asset_past_useful_life_pct lower-is-better. Not money.

Get a single infrastructure network by ID. criticality sets how strictly the network is held to its feature class's Level of Service targets; null is treated as medium.

Get a single infrastructure zone by ID. Boundary is returned as a GeoJSON Polygon.

Get detailed invoice information including amounts, dates, linked vendor, project, and purchase order. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single LoS consequence by ID. Advisory only: no notification is sent. scope_ref holds a criticality tier, a system ID or a feature class code depending on scope_type, and is null for global.

Get a single LoS measure by ID, including all configuration (targets, data source, weights).

Get a single LoS measurement by ID, including value, period, and source metadata.

Get a single LoS proposed target by ID: measure, year, and target_value (in the measure's own unit, not money) or target_statement.

Get a single monthly Level of Service reading by ID. actual is null when there was no data; derived_target is what that facility was held to then, after its criticality was applied. fci and asset_past_useful_life_pct are 0-100 percentages (not fractions), asset_condition_avg is 0-100 and risk_score_avg is 0-25. Not money.

Get a single LoS targets history entry by ID: the target, minimum and stretch goal a measure was set to on effective_date, in the measure's own unit (not money). History exists from 2026-09-20 onward only.

Get detailed manufacturer information including contact details and associated system classes.

Get this organization's display settings: currency_code (ISO 4217), timezone, date_format, company_name, org_category, and which optional modules are enabled (infrastructure, level of service; enable_floorplans is not enforced - floorplans are available on every plan). Call this before presenting any monetary amount - costs, budgets and replacement values returned by every other tool are bare numbers with no currency attached, so stating one without checking risks labelling a Canadian tenant's money as US dollars. Also the fastest way to tell an empty module from one this organization does not…

Get detailed information about a specific part including location and stock levels. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single part category by ID.

Get detailed information about a specific PM schedule including tasks, resources, and linked assets. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get detailed project information including budget, progress, schedule variance, and linked sites. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single project asset assignment by ID.

Get a single project budget item by ID. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single project building assignment by ID.

Get a single project comment by ID.

Get a single project cost snapshot by ID. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single project document by ID.

Get a project document folder template by ID, including its folder structure.

Get a single project ↔ infrastructure feature link by ID.

Get a single project location assignment by ID.

Get a single project milestone by ID.

Get a single project phase by ID.

Get a single project risk by ID, including mitigation and contingency plans.

Get a single project site assignment by ID.

Get a single project system assignment by ID.

Get a single project system class assignment by ID.

Get a single project system group assignment by ID.

Get a single project task by ID, including cost and hour tracking. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single project task dependency by ID.

Get a single project team member by ID.

Get a single project time entry by ID.

Get a single project update by ID.

Get detailed purchase order information including amount, status, vendor, and linked project. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get one purchase order line item by ID. unit_cost is a bare number with no currency: call get_organization_settings for currency_code before stating one.

Get one purchase order link by ID.

Get a single service area by ID, including linked system classes and sites.

Get detailed information about a specific site including address and description. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single site FCI history entry by ID.

Get a single system LoS target by ID. base_target is the organization-wide base for that system and metric, not what any one building is held to (list_system_los_targets explains the criticality adjustment). fci, asset_condition_avg and asset_past_useful_life_pct are 0-100 and risk_score_avg is 0-25; condition is higher-is-better, the others lower-is-better. Not money.

Get a specific organization member by their user ID. Returns name, email, and role. Requires users:read scope.

Get detailed vendor information including contact details, address, and website.

Get a single vendor site assignment by ID, including vendor and site names.

Get detailed information about a specific work order by its ID, including description, dates, costs, and completion details. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

Get a single work order comment by ID.

Get a single work order schedule entry by ID.

Get detailed work request information including description, attachments, and processing status.

List betterments - capital work that extended a facility asset's life, such as an elevator modernization or a boiler retube. Each records what the work cost (capitalized_amount), how much service life it bought (added_life_years), and when it went into service (occurred_on). A betterment re-bases the asset's depreciation from its own date and never changes the asset's original in-service date. Filter by asset_id, project_id or work_order_id. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List comments on assets. Filter by asset_id to get comments for a specific asset.

List point-in-time condition assessments recorded against assets. Filter by asset, assessor, method, condition score range, or assessment date range. Condition scores are 0-100: 85+ Excellent, 70-84 Good, 55-69 Fair, 40-54 Poor, below 40 Critical. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List asset cost records - this is what the AssetLab UI shows on the main "Expenses" page (top-level nav). Each record includes amount, cost_date, category (Repair, PM, Operation, Replacement, Decommission, Other), description, invoice_number, po_number, and links to asset/site/building/work_order. Distinct from list_expenses, which returns project-scoped expenses without invoice/PO fields. Filter by asset, site, category, or work order. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List asset documents (O&M manuals, warranties, specs, etc.). Filter by asset_id or category.

List facility lifecycle strategy events - condition-triggered maintenance/rehabilitation events keyed on an asset-type scope (exactly one of asset_type_id or asset_type_group_id), never on individual assets. The events sharing one scope form that scope's strategy; an asset resolves its type's own strategy first, else its type group's. Filter by asset_type_id, asset_type_group_id, event_class, or is_active. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List parts associated with assets. Filter by asset_id to get all parts for one asset, or by part_id to see all assets using a specific part.

List asset pin placements on floorplans. Each asset has at most one placement globally. Filter by floorplan_id to see all pins on one floor, or by asset_id to find where a specific asset is placed.

List asset replacement plans for lifecycle/capital planning. Filter by asset, status, priority, or planned year. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List asset risk assessment history. Shows risk scores, condition scores, and trigger events over time. Condition scores are 0-100: 85+ Excellent, 70-84 Good, 55-69 Fair, 40-54 Poor, below 40 Critical.

List asset statuses for the organization. These define the lifecycle states an asset or infrastructure feature can be in. Each has a `module`: facilities (assets), infrastructure (features), or null (shared by both); pick one matching the record, or a shared one. The status with system_key archived is the built-in Archived status: assigning it to an asset archives the asset.

List asset type group classifications. Groups organize asset types into logical categories.

List asset type classifications. Filter by group.

List assets in your AssetLab account. Supports filtering by site, building, system class, system group, system, status, and text search. Archived assets (removed from service, kept for their history) are left out unless include_archived is true or status_id names a status. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List file attachments linked to work orders, work requests, PM schedules, or PM templates.

List annual funding budgets - one figure per year, funding source (O&M or Capital) and workspace (module), which is what the dashboard Budget tab shows. Filter by year, funding source, module, site or building. Includes allocated, budgeted, and remaining amounts. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List building type classifications.

List buildings. Optionally filter by site to see all buildings at a specific location.

List change orders. Filter by status, vendor_id, or project_id. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List compliance items (regulatory requirements tracked against PM schedules). Filter by status or system.

List the PM schedules linked to a compliance item, or the compliance items a PM schedule counts toward. Pass compliance_item_id or pm_schedule_id (one is required). Each link carries required_frequency_days (how often the schedule must be completed for the item to stay compliant) and weight.

List compliance records - audit trail of completed compliance checks linked to work orders and PM schedules.

List documents attached to contracts. Filter by contract_id.

List contract-to-site mappings showing which contracts cover which sites. No single-record lookup (composite key).

List vendor contracts. Filter by category or search by title. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List cost categories used to classify expenses, invoices, and purchase orders. Supports hierarchical parent-child structure.

List the organization's criticality modifier overrides. Rows are overrides only: a tier with no row uses the built-in default (critical 0.6, high 0.8, medium 1.0, low 1.4), so an empty list means every tier is on its default. A modifier below 1 tightens the targets of facilities in that tier and one above 1 relaxes them; the allowed range is 0.1 to 1.9. Deleting a row restores the default. Filter by tier.

List custom field definitions configured for this tenant. Filter by entity type (e.g. asset, work_order) or field type.

List custom field values. Filter by entity_id to get all custom fields for a specific record, or by field_definition_id.

List monthly dashboard snapshots with aggregate stats: asset counts, condition scores, work order metrics, and CRV totals. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List project-scoped expenses (the Project → Costs → Expenses tab). These records have description, amount, expense_date, receipt_url, and notes - they do NOT carry invoice_number or po_number. For the records shown on the main AssetLab "Expenses" page (which include invoice_number, po_number, category, and asset/site links), use list_asset_costs instead. Filter by project, work order, or cost category. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List labeled rooms/zones on a floorplan. Each region has a polygon (normalized 0-1 coordinates), an optional location_id linking to the Locations hierarchy, and a "reviewed" flag for AI-detected regions.

List floorplans (PDF page-level floors or site-level sheets). Filter by building_id for a building's floors, or by site_id for site-level plans (campus maps, outdoor layouts). Each floorplan belongs to exactly one of building OR site. A multi-page PDF produces multiple floorplans sharing the same pdf_storage_path.

List the per-question answer values within form responses. Read-only.

List form responses - completed or in-progress fill-outs of a form, attached to a work order or PM. Read-only.

List the items (questions) within form templates. Returned in sort order. Filter by template_id.

List form templates - reusable inspection, checklist, compliance, and survey definitions. Each has a `module`: facilities, infrastructure, or null (shared by both).

List comments on infrastructure features. Filter by feature.

List cost rows for infrastructure features. Filter by feature, work order, category, or cost date range. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List documents attached to infrastructure features. Filter by feature, category, or name search.

List inspections recorded against infrastructure assets. Filter by feature, inspector, method, condition score range, or inspection date range.

List parts associated with infrastructure features. Filter by feature or part.

List the risk + condition history captured for infrastructure features (populated automatically when a feature's risk fields change). Read-only. Filter by feature, source, or capture date range.

List infrastructure assets (features - segments or nodes). Geometry is returned as GeoJSON (Point for nodes, LineString for segments) in EPSG:4326. Filter by network, feature_type, site, status, asset type, condition score range, or risk score range. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List infrastructure feature classes (catalog of classes like water_main, sewer_gravity, pavement). Use the `code` field as the natural key when referencing a class from a network. Filter by category or is_builtin.

List lifecycle strategy events - condition-triggered maintenance/rehabilitation events keyed on a scope (feature_class code, material, optional diameter band), never on individual features. The events sharing one scope form that scope's strategy; features resolve the most specific matching scope like replacement rates. Filter by feature_class, material, event_class, or is_active. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List technical Level of Service targets for infrastructure. One base target per feature class and metric, set once for the organization. Each network of that class is held to a version adjusted by the network's criticality (an unrated network counts as medium): a lower-is-better target is multiplied by the tier's modifier, a higher-is-better one keeps its distance from a perfect score multiplied by it (condition 70 becomes 82 at a Critical network, 58 at a Low one). Derived targets never leave the metric's scale. Metrics: fci (0-100 percent, lower is better), asset_condition_avg (0-100, higher…

List infrastructure networks (named groupings of features bound to one feature class). criticality (critical, high, medium, low) sets how strictly a network is held to its feature class's Level of Service targets; null is treated as medium. Filter by feature_class code or text search.

List operational hydraulic boundaries (pressure zones, DMAs, sewersheds, etc.). Boundary is returned as a GeoJSON Polygon in EPSG:4326. Filter by network or kind.

List invoices. Filter by status (pending, approved, paid, voided), vendor, or project. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List location type classifications (e.g., room types, floor types).

List locations (rooms, floors, areas within buildings). Optionally filter by building or location type.

List Level of Service consequences: what a missed technical target means, in the organization's own words. Advisory only: the statement is shown on the Status screen when a target is breached, and no notification is sent to notify_roles or to anyone else. When several match a breach the most specific scope wins (a specific system or feature class over a criticality tier over global). severity is a floor; the severity shown scales with the size of the gap and the facility's criticality. A null metric matches any metric. Filter by scope type, severity or active.

List LoS measurement values (time-series). Filter by measure, period type, date range, or auto/manual.

List LoS measures. Filter by service area, category, type, data source, or active status.

List proposed levels of service: one row per LoS measure and future year (O. Reg. 588/17 s. 6(1)). A community measure carries target_statement; a technical measure carries target_value, in the measure's own unit (not money). Filter by measure or year.

List monthly technical Level of Service readings, newest first. Read-only. One reading per tracked pair (a system in a building, or an infrastructure network) and metric per month, recorded the first time anyone opens the Status screen in that month, so a month nobody opened it is missing rather than zero. actual is the measured value and is null when there was no data; base_target is the organization-wide target and derived_target is what that facility was held to at the time, after its criticality was applied; status is exceeding, meeting, below, failing or no_data. fci and asset_past_useful…

List recorded changes to a LoS measure's target, minimum and stretch goal, newest first. Recording began on 2026-09-20: a change made before that date left no entry, so an empty list does not mean the target never changed. One entry per measure per day; a second change the same day overwrites that day's entry. Values are in the measure's own unit (not money). Filter by measure ID.

List manufacturers of equipment and assets.

List part categories used to classify inventory parts. Each has a `module`: facilities, infrastructure, or null (shared by both); pick one matching the part's workspace, or a shared one.

List parts/inventory items. Filter by site or category. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List preventive maintenance schedules. Filter by status, frequency, or site. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List preventive maintenance templates that can be used to create PM schedules. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List asset assignments for projects. Filter by project_id or asset_id.

List project budget line items (labor, materials, equipment, subcontractors, permits, contingency, other). Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List building assignments for projects. Filter by project_id or building_id.

List comments on projects. Supports threaded replies via parent_id.

List historical cost snapshots for projects. Filter by project_id to see cost trends over time. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List project document folder templates for reusable folder structures.

List documents attached to projects. Filter by project_id or folder_id.

List links between projects and infrastructure features. Filter by project or feature.

List location assignments for projects. Filter by project_id or location_id.

List project milestones. Filter by project or status (pending, completed, missed, at_risk).

List project phase categories (e.g., Planning, Design, Execution). Sorted by sort_order.

List project phases. Filter by project or status (pending, in_progress, completed, skipped).

List project risks (risk register). Filter by project, status, category, probability, or impact.

List site assignments for projects. Filter by project_id or site_id.

List system class assignments for projects. Filter by project_id or system_class_id.

List system group assignments for projects. Filter by project_id or system_group_id.

List system assignments for projects. Filter by project_id or system_id.

List task dependencies. Filter by task_id or depends_on_task_id to see dependency chains.

List project tasks (work breakdown structure). Filter by project, phase, status, or priority. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List project team members. Filter by project, user, or active status.

List project time entries for labor tracking. Filter by project, task, or user.

List periodic project updates (status reports). Filter by project, timeframe, or year.

List capital projects. Filter by status or health status (on_track, at_risk, delayed, critical). Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List purchase order line items: description, optional part, quantity, unit_cost and quantity_received. Filter by purchase_order_id or part_id. A PO with lines takes its amount from them. unit_cost is a bare number with no currency: call get_organization_settings for currency_code before stating one.

List the extra records a purchase order is linked to for reference: each row has exactly one of work_order_id, pm_schedule_id or project_id. Links never add to committed cost; the PO is charged only to its own project_id / work_order_id. Filter by any of those four IDs.

List purchase orders. Filter by status (draft, issued, partially_received, received, closed, cancelled), vendor, or project. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List site links for service areas. Filter by service_area_id or site_id.

List system class links for service areas. Filter by service_area_id or system_class_id.

List service areas (Level of Service groupings). Filter by active status or search by name.

List Facility Condition Index (FCI) history for sites. fci_value is deferred renewal cost divided by current replacement value, a fraction where LOWER is healthier: below 0.05 good, 0.05-0.10 fair, 0.10 and above poor. It is not a 0-100 condition score. To chart one site, use show_site_fci_trend.

List all sites (physical locations/campuses) in your organization. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List system classes (top-level classification, e.g., "HVAC", "Plumbing", "Electrical").

List system groups (categories of systems, e.g., "Heating", "Cooling"). Optionally filter by system class.

List technical Level of Service targets for building systems. One base target per system and metric, set once for the organization. Each building is held to a version adjusted by its criticality: a lower-is-better target is multiplied by the tier's modifier, a higher-is-better one keeps its distance from a perfect score multiplied by it (condition 70 becomes 82 at a Critical facility, 58 at a Low one). Derived targets never leave the metric's scale. Metrics: fci (0-100 percent, lower is better), asset_condition_avg (0-100, higher is better, read with the fixed condition bands), asset_past_usef…

List systems (e.g., HVAC units, plumbing systems, electrical systems). Optionally filter by system group.

List organization members. Returns user IDs, names, emails, and roles. Requires users:read scope. Note: This exposes personal information - only use when the user explicitly requests member data.

List vendor-to-site assignments showing which vendors serve which sites.

List vendors. Filter by status, category, or city.

List work categories used to classify work orders and requests. Each has a `module`: facilities, infrastructure, or null (shared by both). Pick a category whose module matches the work - infrastructure for work on a feature, facilities otherwise - or a shared one.

List comments on work orders. Filter by work_order_id to get comments for a specific work order.

List work order schedules (technician day plans). Filter by technician_id + scheduled_date to get one technician's ordered day: rows are returned by date, then stop_order (the day-plan stop sequence; rows without stop_order sort last), then start time. travel_time_minutes is a straight-line estimate from the previous stop.

List work orders. Filter by status (NEW, IN_PROGRESS, ON_HOLD, COMPLETED, CANCELLED), priority (LOW, MEDIUM, HIGH, URGENT), type (PM, REACTIVE), and site. Amounts are bare numbers with no currency: call get_organization_settings for currency_code before stating one.

List work requests (submitted by requesters). Filter by status (PENDING_REVIEW, APPROVED, REJECTED) or priority.

Show one site’s Facility Condition Index (FCI) history as a chart, in clients that render MCP Apps; other clients get the same summary as text. FCI is deferred renewal cost divided by current replacement value, a fraction where LOWER is healthier: good below 5%, fair 5-10%, poor 10% and above. It is not a 0-100 condition score. Resolve site_id with list_sites first.

Update an existing asset by ID. Requires assets:write scope. When changing location, resolve top-down: list_sites → list_buildings (by site_id) → list_locations (by building_id). Provide all three IDs. Same for systems: list_system_classes → list_system_groups → list_systems.

Update a betterment by ID. The asset it belongs to cannot be changed - delete and re-create to move one. The row must still add either capital or life after the update. Requires asset_betterments:write scope.

Update an existing asset comment by ID. Requires asset_comments:write scope.

Update an existing asset condition assessment by ID. Requires asset_condition_assessments:write scope. Note: the purchase-cost writeback is create-only and cannot be triggered by an update.

Update an existing asset cost entry by ID - the record type shown on the AssetLab "Expenses" page. Requires asset_costs:write scope.

Update an asset document by ID. Requires asset_documents:write scope.

Update a facility lifecycle strategy event by ID. Editing re-confirms the cost (cost_reviewed_on is server-set). Set is_active false to disable an event without deleting it - projections recompute immediately. Requires asset_lifecycle_events:write scope.

Update the quantity of an asset-part association by ID. Requires asset_parts:write scope.

Move an asset placement to new coordinates or a different floorplan. Requires asset_placements:write scope.

Update an existing asset replacement plan by ID. Requires asset_replacement_plans:write scope.

Update an existing asset status by ID. Requires asset_statuses:write scope. On the built-in Archived status (system_key archived) only name and description can change.

Update an existing asset type by ID. Requires asset_types:write scope.

Update an existing asset type group by ID. Requires asset_type_groups:write scope.

Update an attachment by ID. Requires attachments:write scope.

Update an existing budget by ID. Requires budgets:write scope.

Update an existing building by ID. Requires buildings:write scope. latitude and longitude must be sent together; send both as null to clear the building position.

Update an existing building type by ID. Requires building_types:write scope.

Update an existing change order by ID. Requires change_orders:write scope.

Update an existing compliance item by ID. Requires compliance:write scope.

Change the required frequency or weight of a compliance item to PM schedule link. Requires compliance:write scope. To point a link at a different item or schedule, delete it and create a new one.

Update an existing compliance record by ID. Requires compliance_records:write scope.

Update an existing contract by ID. Requires contracts:write scope.

Update a contract document by ID. Requires contract_documents:write scope.

Update an existing cost category by ID. Requires cost_categories:write scope.

Update a criticality modifier override by ID. Below 1 tightens the targets of facilities in that tier, above 1 relaxes them. Requires los_targets:write scope.

Update an existing custom field definition by ID. Requires custom_fields:write scope.

Update an existing custom field value by ID. Set whichever typed column matches the definition's field_type (value_text / value_number / value_date / value_boolean), or pass a single `value` and the server will dispatch it. Requires custom_fields:write scope.

Update an existing expense by ID. Requires expenses:write scope.

Update floorplan metadata (rename floor, reorder, set status). Requires floorplans:write scope.

Update a floorplan region - rename, reshape polygon, link to a Location, or mark as reviewed. Requires floorplan_regions:write scope.

Update an existing form template by ID. Requires form_templates:write scope.

Update an existing form template item by ID. template_id and item_key are immutable and cannot be changed. Requires form_template_items:write scope.

Update an existing infrastructure asset (feature) by ID. To change geometry, provide a new GeoJSON Point/LineString matching the existing feature_type. Computed columns (length_m, slope_pct, risk_score) cannot be set. Requires infrastructure_assets:write scope.

Update an infrastructure asset comment by ID. Requires infrastructure_asset_comments:write scope.

Update an infrastructure asset cost by ID. Requires infrastructure_asset_costs:write scope.

Update infrastructure asset document metadata by ID. Requires infrastructure_asset_documents:write scope.

Update an existing infrastructure asset inspection by ID. Requires infrastructure_asset_inspections:write scope.

Update an infrastructure asset part association by ID. Requires infrastructure_asset_parts:write scope.

Update a tenant-defined infrastructure feature class (addressed by code). The `code`, `category`, and `is_builtin` fields are immutable; attempts to change them on a builtin class return 409. Requires infrastructure_feature_classes:write scope.

Update a lifecycle strategy event by ID. Editing re-confirms the cost (cost_reviewed_on is server-set). Set is_active false to disable an event without deleting it - projections recompute immediately. Requires infrastructure_lifecycle_events:write scope.

Update an infrastructure LoS target by ID. base_target stays on 0-100. Requires los_targets:write scope.

Update an existing infrastructure network by ID. Requires infrastructure_networks:write scope.

Update an infrastructure zone by ID. Pass boundary as a GeoJSON Polygon or MultiPolygon to replace the geometry. Requires infrastructure_zones:write scope.

Update an existing invoice by ID. Requires invoices:write scope.

Update an existing location by ID. Requires locations:write scope.

Update an existing location type by ID. Requires location_types:write scope.

Update a LoS consequence by ID. Changing scope_type to global clears scope_ref; changing it to anything else needs a scope_ref that fits the new type. Advisory only: no notification is sent. Requires los_consequences:write scope.

Update an existing LoS measure by ID. Requires los_measures:write scope.

Update an existing LoS measurement by ID. Requires los_measurements:write scope.

Update an existing LoS proposed target by ID. Requires los_proposed_targets:write scope.

Update an existing manufacturer by ID. Requires manufacturers:write scope.

Update an existing part/inventory item by ID. Requires parts:write scope.

Update an existing part category by ID. Requires part_categories:write scope.

Update an existing PM schedule by ID. Requires pm_schedules:write scope. When changing location, resolve top-down: list_sites → list_buildings (by site_id) → list_locations (by building_id). Provide all three IDs.

Update an existing PM template by ID. Requires pm_templates:write scope.

Update an existing project by ID. Requires projects:write scope.

Update an existing project budget item by ID. Requires project_budget_items:write scope.

Update an existing project comment by ID. Requires project_comments:write scope.

Update a project document by ID. Requires project_documents:write scope.

Update a project document folder template by ID. Requires project_document_folder_templates:write scope.

Update a project ↔ infrastructure feature link by ID. Requires project_infrastructure_assets:write scope.

Update an existing project milestone by ID. Requires project_milestones:write scope.

Update an existing project phase by ID. Requires project_phases:write scope.

Update an existing project phase category by ID. Requires project_phase_categories:write scope.

Update an existing project risk by ID. Requires project_risks:write scope.

Update an existing project task by ID. Requires project_tasks:write scope.

Update a project team member by ID. Requires project_team_members:write scope.

Update an existing project time entry by ID. Requires project_time_entries:write scope.

Update an existing project update by ID. Requires project_updates:write scope.

Update an existing purchase order by ID. Requires purchase_orders:write scope.

Update a purchase order line item. Requires purchase_orders:write scope. To receive goods, set quantity_received; for a line with a part, the change is added to (or taken from) that part's stock. A line with stock received cannot change its part.

Update an existing service area by ID. Requires service_areas:write scope.

Update an existing site by ID. Requires sites:write scope.

Update an existing system by ID. Requires systems:write scope.

Update an existing system class by ID. Requires systems:write scope.

Update an existing system group by ID. Requires systems:write scope.

Update a system LoS target by ID. base_target must sit on the scale of the metric in force (0-100, or 0-25 for risk_score_avg), so send a new base_target when changing to a metric with a smaller scale. Direction follows the metric automatically. Requires los_targets:write scope.

Update an existing vendor by ID. Requires vendors:write scope.

Update an existing work category by ID. Requires work_categories:write scope.

Update an existing work order by ID. Requires work_orders:write scope. When changing location, resolve top-down: list_sites → list_buildings (by site_id) → list_locations (by building_id). Provide all three IDs. To complete a work order, set status COMPLETED and say what was done in completion_notes; completed_at is stamped automatically.

Update an existing work order comment by ID. Requires work_order_comments:write scope.

Update a work order schedule entry by ID (date, times, stop_order, notes). work_order_id is immutable. Requires work_order_schedules:write scope.

Update an existing work request by ID. Requires work_requests:write scope. Setting status to APPROVED creates a new work order from the request (its title, location and asset carry over) - confirm with the user first, and look the work order up afterwards with list_work_orders; REJECTED creates nothing. When changing location, resolve top-down: list_sites → list_buildings (by site_id) → list_locations (by building_id). Provide all three IDs.

Upload a file to AssetLab storage by sending its bytes inline (base64). The AssetLab backend performs the storage upload server-side - use this tool when the client cannot PUT directly to Supabase Storage (e.g. Claude integrations whose outbound network blocks arbitrary supabase.co hosts). Returns { path, bucket, file_size, content_type }. After uploading, pass path to the appropriate record tool (update_asset image_url, create_asset_document file_path, update_work_order image_url, create_attachment file_url, create_project_document file_path, create_contract_document file_path). Server limit …