---
title: "Merge immutable, revision-aware meter history"
method: POST
path: "/api/forecast-sandbox/consumption/portfolio/history"
tags: ["Forecast Sandbox"]
---

# Merge immutable, revision-aware meter history

`POST /api/forecast-sandbox/consumption/portfolio/history`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/forecast-sandbox/consumption/portfolio/history`
- Auth: none declared

Live training/history/model access requires a credential bound to the tenant; a tenant header alone is insufficient. Shared-baseline contributors remain internal; only tenant-owned meter predictions are returned.

## Query parameters

- `token` string

## Request body

- object
  - `dataset` object
    - `series_id` string, required
    - `unit` 'kWh' | 'kW', required
    - `timezone` string, required
    - `value_semantics` 'interval_energy' | 'average_power': kWh per interval or mean kW; cumulative OBIS register readings must be differenced before upload.
    - `profile_label` string
    - `profile_available_at` string, date-time
    - `period_from` string, date
    - `period_until` string, date
    - `values` object[], required
      - `timestamp` string, date-time, required
      - `value` number, required
      - `reactive_power_kvar` number, nullable: Optional mean reactive power over the same quarter-hour; signed kvar. Missing is not zero.
      - `available_at` string, date-time
  - `dataset_id` string
  - `historical_import` boolean
  - `allow_corrections` boolean
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Result, immutable version, or durable result manifest

- object

## Other responses

- `202`: Forecast job accepted. Poll statusUrl/progressUrl; fetch resultUrl once completed. CPU work runs in a separate worker.
- `400`: Invalid input, unknown tenant-owned artifact, or incompatible resume
- `401`: Credential with a bound tenant is required for live model operations

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)