---
title: "Upsert a default record value configuration for an asset"
method: POST
path: "/app/v1/default_record_value_configurations"
tags: ["default_record_value_configuration"]
---

# Upsert a default record value configuration for an asset

`POST /app/v1/default_record_value_configurations`

## Request body

- DefaultRecordValueConfigurationInput
  - `asset_id` string, uuid
  - `reporting_group_id` string
  - `measurement_type` string
  - `measurement_unit` string
  - `default_value` number, nullable
  - `configuration` union
    - object
      - `filter` object — A filter object for Form Submissions where it can filter based on any of these following fields. No fields are mandatory and the syntax is roughly the same as MongoDB querying.
        - `id` string, uuid
        - `version` integer
        - `current_version` boolean
        - `status` 'validated' | 'invalidated' | 'pending' | 'submitted' | 'draft'
        - `form_category_id` string
        - `form_category.name` string
        - `form_schema.id` string
        - `form_schema.name` string
        - `form_schema.version` number
        - `form_schema.current_version` boolean
        - `form_schema.status` 'active' | 'archived' | 'draft'
        - `related_entity_id` string, uuid
        - `created_by` string, uuid
        - `created_at` string, date-time
        - `updated_at` string, date-time
        - `event.id` string, uuid
        - `measurement.measurement_type` string
        - `measurement.measurement_unit` string
        - `measurement.source_id` string, uuid
        - `measurement.subject_id` string, uuid
        - `measurement.form_submission_id` string, uuid
        - `measurement.section_id` string
        - `measurement.question_id` string
        - `measurement.question_index` number
        - `measurement.time` string, date-time
      - `configuration_type` 'form_measurement'
      - `aggregate_function` 'top' | 'avg' | 'sum'
      - `sort` 'measurement.time' | 'measurement.value' | 'measurement.question_index' | 'measurement.created_at' | 'form_submission.created_at' | 'form_submission.updated_at' | 'form_schema.name' | 'form_schema.created_at' | 'form_schema.updated_at' | 'form_category.name' | 'form_category.created_at' | 'form_category.updated_at'
      - `sort_direction` 'asc' | 'desc'
      - `second_sort` 'measurement.time' | 'measurement.value' | 'measurement.question_index' | 'measurement.created_at' | 'form_submission.created_at' | 'form_submission.updated_at' | 'form_schema.name' | 'form_schema.created_at' | 'form_schema.updated_at' | 'form_category.name' | 'form_category.created_at' | 'form_category.updated_at'
      - `window` string — Fetch results within a window relative to measurement time of the form measurement (1 month, 3 month, 1 year)
      - `timezone` string
    - object
      - `configuration_type` 'calculator_result'
      - `aggregate_function` 'top' | 'avg' | 'sum'
      - `sort` string
      - `sort_direction` 'asc' | 'desc'
      - `window` string — Fetch results within a window relative to the year_month of the calculator result (1 month, 3 month, 1 year)
      - `timezone` string
      - `filter` CalculatorResultFilterFields
        - `equipment.custom_attributes` object
        - `equipment.id` string
        - `equipment.name` string
        - `equipment.status` 'active' | 'inactive' | 'deprecated'
        - `equipment.type.id` string
        - `equipment.type.name` string
        - `equipment.facility.custom_attributes` object
        - `equipment.facility.id` string
        - `equipment.facility.name` string
        - `equipment.facility.status` string
        - `estimation_method.id` string
        - `estimation_method.name` string
        - `estimation_method.entity_id` string
        - `estimation_method.analytics_library_id` string
        - `estimation_method.analytics_calculator_id` string
        - `estimation_method.created_at` string
        - `estimation_method.created_by` string
        - `estimation_method.updated_at` string
        - `estimation_method.updated_by` 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
        - `flow.equipment.custom_attributes` object
        - `flow.equipment.id` string
        - `flow.equipment.name` string
        - `flow.equipment.status` 'active' | 'inactive' | 'deprecated'
        - `flow.equipment.type.id` string
        - `flow.facility.custom_attributes` object
        - `flow.facility.id` string
        - `flow.facility.name` string
        - `flow.facility.status` string
        - `entity_type` string
        - `entity_id` string, uuid
        - `reporting_group` string
        - `measurement_type` string
        - `year_month` string
    - object
      - `configuration_type` 'measurement_series'
      - `aggregate_function` 'top' | 'avg' | 'sum'
      - `window` string — Fetch results within a window relative to measurement time of the measurement value (1 month, 3 month, 1 year)
      - `timezone` string
      - `filter` MeasurementSeriesFilter
        - `filter` object — A filter object for measurement series where it can filter based on any of these following fields. No fields are mandatory and the syntax is roughly the same as MongoDB querying.
          - `device_id` string, uuid
          - `description` string
          - `measurement_type` string
          - `measurement_unit` string
          - `measurement_subject_id` string, uuid
          - `device.custom_attributes` object
          - `device.name` string
          - `device.type_id` string
          - `device.status` string
          - `device.facility.custom_attributes` object
          - `device.facility.id` string
          - `device.facility.name` string
          - `device.facility.status` string

## Response `200`

A successful operation

- DefaultRecordValueConfiguration
  - `id` string, uuid
  - `asset_id` string, uuid
  - `reporting_group_id` string
  - `measurement_type` string
  - `measurement_unit` string
  - `default_value` number, nullable
  - `configuration` union
    - object
      - `filter` object — A filter object for Form Submissions where it can filter based on any of these following fields. No fields are mandatory and the syntax is roughly the same as MongoDB querying.
        - `id` string, uuid
        - `version` integer
        - `current_version` boolean
        - `status` 'validated' | 'invalidated' | 'pending' | 'submitted' | 'draft'
        - `form_category_id` string
        - `form_category.name` string
        - `form_schema.id` string
        - `form_schema.name` string
        - `form_schema.version` number
        - `form_schema.current_version` boolean
        - `form_schema.status` 'active' | 'archived' | 'draft'
        - `related_entity_id` string, uuid
        - `created_by` string, uuid
        - `created_at` string, date-time
        - `updated_at` string, date-time
        - `event.id` string, uuid
        - `measurement.measurement_type` string
        - `measurement.measurement_unit` string
        - `measurement.source_id` string, uuid
        - `measurement.subject_id` string, uuid
        - `measurement.form_submission_id` string, uuid
        - `measurement.section_id` string
        - `measurement.question_id` string
        - `measurement.question_index` number
        - `measurement.time` string, date-time
      - `configuration_type` 'form_measurement'
      - `aggregate_function` 'top' | 'avg' | 'sum'
      - `sort` 'measurement.time' | 'measurement.value' | 'measurement.question_index' | 'measurement.created_at' | 'form_submission.created_at' | 'form_submission.updated_at' | 'form_schema.name' | 'form_schema.created_at' | 'form_schema.updated_at' | 'form_category.name' | 'form_category.created_at' | 'form_category.updated_at'
      - `sort_direction` 'asc' | 'desc'
      - `second_sort` 'measurement.time' | 'measurement.value' | 'measurement.question_index' | 'measurement.created_at' | 'form_submission.created_at' | 'form_submission.updated_at' | 'form_schema.name' | 'form_schema.created_at' | 'form_schema.updated_at' | 'form_category.name' | 'form_category.created_at' | 'form_category.updated_at'
      - `window` string — Fetch results within a window relative to measurement time of the form measurement (1 month, 3 month, 1 year)
      - `timezone` string
    - object
      - `configuration_type` 'calculator_result'
      - `aggregate_function` 'top' | 'avg' | 'sum'
      - `sort` string
      - `sort_direction` 'asc' | 'desc'
      - `window` string — Fetch results within a window relative to the year_month of the calculator result (1 month, 3 month, 1 year)
      - `timezone` string
      - `filter` CalculatorResultFilterFields
        - `equipment.custom_attributes` object
        - `equipment.id` string
        - `equipment.name` string
        - `equipment.status` 'active' | 'inactive' | 'deprecated'
        - `equipment.type.id` string
        - `equipment.type.name` string
        - `equipment.facility.custom_attributes` object
        - `equipment.facility.id` string
        - `equipment.facility.name` string
        - `equipment.facility.status` string
        - `estimation_method.id` string
        - `estimation_method.name` string
        - `estimation_method.entity_id` string
        - `estimation_method.analytics_library_id` string
        - `estimation_method.analytics_calculator_id` string
        - `estimation_method.created_at` string
        - `estimation_method.created_by` string
        - `estimation_method.updated_at` string
        - `estimation_method.updated_by` 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
        - `flow.equipment.custom_attributes` object
        - `flow.equipment.id` string
        - `flow.equipment.name` string
        - `flow.equipment.status` 'active' | 'inactive' | 'deprecated'
        - `flow.equipment.type.id` string
        - `flow.facility.custom_attributes` object
        - `flow.facility.id` string
        - `flow.facility.name` string
        - `flow.facility.status` string
        - `entity_type` string
        - `entity_id` string, uuid
        - `reporting_group` string
        - `measurement_type` string
        - `year_month` string
    - object
      - `configuration_type` 'measurement_series'
      - `aggregate_function` 'top' | 'avg' | 'sum'
      - `window` string — Fetch results within a window relative to measurement time of the measurement value (1 month, 3 month, 1 year)
      - `timezone` string
      - `filter` MeasurementSeriesFilter
        - `filter` object — A filter object for measurement series where it can filter based on any of these following fields. No fields are mandatory and the syntax is roughly the same as MongoDB querying.
          - `device_id` string, uuid
          - `description` string
          - `measurement_type` string
          - `measurement_unit` string
          - `measurement_subject_id` string, uuid
          - `device.custom_attributes` object
          - `device.name` string
          - `device.type_id` string
          - `device.status` string
          - `device.facility.custom_attributes` object
          - `device.facility.id` string
          - `device.facility.name` string
          - `device.facility.status` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `created_by` string, uuid
  - `updated_by` string, uuid

---

[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)