---
title: "Plan dimming events based on load forecast"
method: POST
path: "/api/flex/events/plan"
tags: ["Flex (§14a Flexibilitätsmanagement)"]
---

# Plan dimming events based on load forecast

`POST /api/flex/events/plan`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/flex/events/plan`
- Auth: none declared

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.

## Query parameters

- `token` string

## Request body

- object
  - `date` string, required
  - `gridCapacityKw` number, required
  - `postalCode` string
  - `threshold` number
  - `loadForecastOverride` object[]
    - `ts` string
    - `value` number
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Successful response

- object

---

[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)