Datapoints

Create a Snapshot — seal a consistent set of Datapoints

Refreshes all specified datapoints (sequentially) if their cached data is older than maxAgeMinutes, then seals the consistent state as a snapshot document in PouchDB. The snapshot records each datapoints provenanceHashand a combinedsnapshotHash(SHA-256 over sorted individual hashes). Accepts eitherdatapointNames(array) ortags` (comma-separated string). Raw data is NOT stored (KRITIS constraint).

post/api/datapoints/snapshot

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/datapoints/snapshot
  • Auth: none declared

Query parameters

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Request body

datapointNamesstring[]
tagsstring

Comma-separated tag filter. Mutually exclusive with datapointNames.

maxAgeMinutesnumber

Maximum age of a datapoint before a refresh is triggered.

namestring
descriptionstring
createdBy'manual' | 'agent' | 'scheduler'
tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "datapointNames": [
    "pv-portfolio-stromdao-netze",
    "redispatch-anlagen-stromdao-netze"
  ],
  "tags": "stromdao-netze,redispatch-pipeline",
  "name": "stromdao-validierung-q1-2026"
}

Response

Successful response

object required

Changes

No recorded changes to this operation across all 2 revisions of this API.