Flex (§14a Flexibilitätsmanagement)

Register a controllable device (§14a EnWG)

Registers a controllable consumption device (wallbox, heat pump, storage) for §14a grid management. Devices are eligible for reduced network tariffs in exchange for temporary dimming.

post/api/flex/devices

Request

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

deviceIdstring required
type'wallbox' | 'heat_pump' | 'storage' | 'air_conditioning' | 'other' required
capacityKwnumber required
minDimmingKwnumber
meloIdstring
customerNamestring
postalCodestring
steuerboxIdstring
registeredSincestring
tokenstring

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

Example request

{
  "deviceId": "wb_test_001",
  "type": "wallbox",
  "capacityKw": 11,
  "minDimmingKw": 4.2,
  "meloId": "DE0012345678901234567890123456789",
  "customerName": "Max Mustermann",
  "postalCode": "66989",
  "steuerboxId": "STB-001",
  "registeredSince": "2026-04-26T10:00:00.000Z"
}

Response

Successful response

object required

Changes

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