Flex (§14a Flexibilitätsmanagement)

Plan dimming events based on load forecast

Analyzes load forecast against grid capacity and generates a dimming plan. Respects §14a constraints: min 4.2 kW, max 2h duration, min 2h cooldown between events.

post/api/flex/events/plan

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/flex/events/plan
  • 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

datestring required
gridCapacityKwnumber required
postalCodestring
thresholdnumber
tokenstring

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

Example request

{
  "date": "2026-04-20",
  "gridCapacityKw": 100,
  "postalCode": "66989",
  "threshold": 0.85,
  "loadForecastOverride": [
    {
      "ts": "2026-04-20T18:00:00.000Z",
      "value": 95
    },
    {
      "ts": "2026-04-20T18:15:00.000Z",
      "value": 92
    }
  ]
}

Response

Successful response

object required

Changes

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