---
title: "Upsert a measurement"
method: PUT
path: "/app/v1/measurements/{measurement_series_id}"
tags: ["measurements"]
---

# Upsert a measurement

`PUT /app/v1/measurements/{measurement_series_id}`

## Path parameters

- `measurement_series_id` string, uuid, required

## Request body

- object
  - `measurement_type` string, required
  - `measurement_unit` string, required
  - `records` MeasurementInputRecord[], required
    - `timestamp` string, date-time, required
    - `value` number, required
  - `subjects` object[]
    - `entity_id` string, uuid
    - `entity_type` 'equipment' | 'device' | 'facility' | 'flow' | 'asset_group'
    - `start_time` string, date-time

## Response `200`

successful operation

- object
  - `recordsWritten` integer
  - `success` boolean

## Other responses

- `400` — unsuccessful operation

---

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