---
title: "Create or update a record"
method: PUT
path: "/app/v1/records"
tags: ["records"]
---

# Create or update a record

`PUT /app/v1/records`

## Request body

- object
  - `asset_id` string, uuid — Either asset_id or asset_filter is required
  - `asset_filter` object — Either asset_id or asset_filter is required
    - `facility.custom_attributes` object
    - `facility.id` string
    - `facility.name` string
    - `facility.status` string
    - `equipment.custom_attributes` object
    - `equipment.id` string
    - `equipment.name` string
    - `equipment.status` 'active' | 'inactive' | 'deprecated'
    - `equipment.type.id` string
    - `equipment.type.name` string
    - `device.attributes` object
    - `device.custom_attributes` object
    - `device.id` string
    - `device.measurement_types` string
    - `device.name` string
    - `device.status` string
    - `device.type_id` string
    - `flow.id` string
    - `flow.name` string
    - `flow.status` 'active' | 'inactive'
    - `flow.type` string — Use `id` value of any index in `GET /v1/flow_types`
    - `flow.product_type` string — Use `id` value of any index in `GET /v1/product_types`
    - `flow.product_category` string — Use `id` value of any index in `GET /v1/product_categories`
    - `flow.custom_attributes` CustomAttributes
    - `flow.associated_facility_id` string, uuid
    - `flow.associated_equipment_id` string, uuid
    - `equipment.facility.custom_attributes` object
    - `equipment.facility.id` string
    - `equipment.facility.name` string
    - `equipment.facility.status` string
    - `flow.facility.custom_attributes` object
    - `flow.facility.id` string
    - `flow.facility.name` string
    - `flow.facility.status` string
  - `reporting_group_id` string
  - `year_month` string
  - `values` object[]
    - `value` number
    - `measurement_unit` string
    - `configuration` union
      - object
        - `configuration_type` 'manual'
        - `value` number
        - `sources` object[]
      - object
        - `configuration_type` 'form_measurement'
        - `aggregate_function` 'avg' | 'sum'
        - `form_category_id` string, uuid
        - `measurement_ids` string[]
        - `sources` object[]
      - object
        - `configuration_type` 'calculator_result'
        - `aggregate_function` 'avg' | 'sum'
        - `calculator_result_ids` string[]
        - `sources` object[]
      - object
        - `configuration_type` 'measurement_series'
        - `aggregate_function` 'avg' | 'sum'
        - `measurement_series_id` string, uuid
        - `start` string, date-time
        - `end` string, date-time
        - `Interval` '1minute' | '15minute' | '1hour' | '1day'
        - `sources` object[]
    - `note` string
    - `attachment_ref` string
    - `attachment_filename` string
    - `measurement_type` string

## Response `200`

A successful operation

- Record
  - `asset_id` string, uuid — Either asset_id or asset_filter is required
  - `asset_filter` object — Either asset_id or asset_filter is required
    - `facility.custom_attributes` object
    - `facility.id` string
    - `facility.name` string
    - `facility.status` string
    - `equipment.custom_attributes` object
    - `equipment.id` string
    - `equipment.name` string
    - `equipment.status` 'active' | 'inactive' | 'deprecated'
    - `equipment.type.id` string
    - `equipment.type.name` string
    - `device.attributes` object
    - `device.custom_attributes` object
    - `device.id` string
    - `device.measurement_types` string
    - `device.name` string
    - `device.status` string
    - `device.type_id` string
    - `flow.id` string
    - `flow.name` string
    - `flow.status` 'active' | 'inactive'
    - `flow.type` string — Use `id` value of any index in `GET /v1/flow_types`
    - `flow.product_type` string — Use `id` value of any index in `GET /v1/product_types`
    - `flow.product_category` string — Use `id` value of any index in `GET /v1/product_categories`
    - `flow.custom_attributes` CustomAttributes
    - `flow.associated_facility_id` string, uuid
    - `flow.associated_equipment_id` string, uuid
    - `equipment.facility.custom_attributes` object
    - `equipment.facility.id` string
    - `equipment.facility.name` string
    - `equipment.facility.status` string
    - `flow.facility.custom_attributes` object
    - `flow.facility.id` string
    - `flow.facility.name` string
    - `flow.facility.status` string
  - `reporting_group_id` string
  - `year_month` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `created_by` string, uuid
  - `updated_by` string, uuid
  - `id` string, uuid
  - `asset_type` 'equipment' | 'device' | 'facility' | 'flow' | 'asset_group'
  - `company_id` string, uuid
  - `values` RecordValue[]
    - `value` number
    - `measurement_unit` string
    - `configuration` union
      - object
        - `configuration_type` 'manual'
        - `value` number
        - `sources` object[]
      - object
        - `configuration_type` 'form_measurement'
        - `aggregate_function` 'avg' | 'sum'
        - `form_category_id` string, uuid
        - `measurement_ids` string[]
        - `sources` object[]
      - object
        - `configuration_type` 'calculator_result'
        - `aggregate_function` 'avg' | 'sum'
        - `calculator_result_ids` string[]
        - `sources` object[]
      - object
        - `configuration_type` 'measurement_series'
        - `aggregate_function` 'avg' | 'sum'
        - `measurement_series_id` string, uuid
        - `start` string, date-time
        - `end` string, date-time
        - `Interval` '1minute' | '15minute' | '1hour' | '1day'
        - `sources` object[]
    - `note` string
    - `attachment_ref` string
    - `attachment_filename` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `created_by` string, uuid
    - `updated_by` string, uuid
    - `id` string, uuid
    - `record_id` string, uuid
    - `measurement_type` string

---

[API](https://skmtc.net/validere/apis/carbonhub-api.md) · [All operations](https://skmtc.net/validere/apis/carbonhub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/validere/carbonhub-api/revisions/053edab62415/schema)