Flex (§14a Flexibilitätsmanagement)

Execute dimming event (real or simulated)

Executes a dimming plan or single device dimming. Publishes MQTT command to cernion/flex/{deviceId}/dimming topic and stores events for Entlastungsnachweis.

post/api/flex/events/execute

Request

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

planIdstring
deviceIdstring
durationMinutesnumber
dimmedPowerKwnumber
tokenstring

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

Example request

{
  "planId": "flexplan_1714123456789_ab12cd34",
  "deviceId": "wb_test_001",
  "durationMinutes": 30,
  "dimmedPowerKw": 4.2
}

Response

Successful response

object required

Changes

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