---
title: "Patch Datapoint"
method: PATCH
path: "/datapoints/{id}"
---

# Patch Datapoint

`PATCH /datapoints/{id}`

Updates a datapoint in the Isometric system. Associated components and removals will be recalculated, if they are not in an immutable state.

## Path parameters

- `id` string, required

## Headers

- `x-client-secret` string, required — A secret token identifying the client connecting to the API

## Request body

- PatchDatapointRequest
  - `type` union
    - 'CONSTANT' | 'STANDARD_PUBLISHED_VALUE' | 'REPORTED' | 'ASSUMPTION' | 'DERIVED'
    - Undefined — An explicit representation of an undefined value in the Isometric REST API. Used, for example, to distinguish between explicit null inputs that clear a property, and not provided inputs which leave the property as is.
      - `__typename` 'Undefined' — Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.
  - `display_name` union
    - string
    - Undefined — An explicit representation of an undefined value in the Isometric REST API. Used, for example, to distinguish between explicit null inputs that clear a property, and not provided inputs which leave the property as is.
      - `__typename` 'Undefined' — Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.
  - `description` union
    - string — A free-text description of the datapoint. Must be at most 500 characters long.
    - Undefined — An explicit representation of an undefined value in the Isometric REST API. Used, for example, to distinguish between explicit null inputs that clear a property, and not provided inputs which leave the property as is.
      - `__typename` 'Undefined' — Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.
  - `quantity` union
    - DatapointQuantityInput
      - `magnitude` number, required
      - `unit` string, nullable, required
      - `standard_deviation` number, nullable — The standard deviation of the datapoint in the same units as the magnitude. Leave null if the datapoint is not to be included in the uncertainty analysis for the removal.
    - Undefined — An explicit representation of an undefined value in the Isometric REST API. Used, for example, to distinguish between explicit null inputs that clear a property, and not provided inputs which leave the property as is.
      - `__typename` 'Undefined' — Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.
  - `source_ids` union — Overwrite existing source IDs
    - string[]
    - Undefined — An explicit representation of an undefined value in the Isometric REST API. Used, for example, to distinguish between explicit null inputs that clear a property, and not provided inputs which leave the property as is.
      - `__typename` 'Undefined' — Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.
  - `uncertainty_justification` union — Provide an uncertainty justification where required for inputs identified as sensitive in sensitivity analysis.
    - string
    - Undefined — An explicit representation of an undefined value in the Isometric REST API. Used, for example, to distinguish between explicit null inputs that clear a property, and not provided inputs which leave the property as is.
      - `__typename` 'Undefined' — Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.

## Response `200`

Successful Response

- Datapoint
  - `id` string, required
  - `supplier_reference_id` string, nullable, required — A string that must be unique for all resources created by a specific supplier. It can be used by a client to identify the correct objects in their system.
  - `display_name` string, required
  - `type` 'CONSTANT' | 'STANDARD_PUBLISHED_VALUE' | 'REPORTED' | 'ASSUMPTION' | 'DERIVED', required
  - `quantity` ScalarQuantity, required
    - `magnitude` number, required
    - `unit` string, required
    - `standard_deviation` number, nullable
  - `description` string, nullable, required
  - `source_ids` string[], required
  - `measured_at` string, date-time, nullable, required
  - `project_id` string, nullable, required
  - `locked_status` 'not_locked' | 'locked_library_datapoint' | 'locked_time_series_datapoint' | 'locked_measurement_sample_datapoint' | 'locked_forestry_field_measurement_datapoint' | 'locked_model_output_datapoint' | 'locked_model_input_datapoint' | 'locked_material_datapoint' | 'locked_activity_datapoint' | 'locked_used_in_verified_removal', required — Represents the locked status of a Datapoint. Locked Datapoints cannot be updated: if an updated version of a data input is required then a new Datapoint must be created.
  - `uncertainty_justification` string, nullable — Provide an uncertainty justification where required for inputs identified as sensitive in sensitivity analysis.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/isometric/apis/isometric-certify-data-ingestion-api.md) · [All operations](https://skmtc.net/isometric/apis/isometric-certify-data-ingestion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/isometric/isometric-certify-data-ingestion-api/versions/9819e9c8ccf0/schema)