---
title: "Prepare grid connection validation config — draft only, no write"
method: POST
path: "/api/copilot-process/grid-connection/prepare-validation"
tags: ["Copilot Process"]
---

# Prepare grid connection validation config — draft only, no write

`POST /api/copilot-process/grid-connection/prepare-validation`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/copilot-process/grid-connection/prepare-validation`
- Auth: none declared

Validates the input parameters and returns a draft validation configuration.
**No writes**: This action has no side effects. The returned proposal must be confirmed before the actual 6-step pipeline is started.
At least one of `gridOperatorId`, `gridOperatorBdew`, or `gridOperatorName` is required.

The consequential execute action (`POST /api/grid-connection/validate`) is Phase 3.

## Query parameters

- `token` string

## Request body

- object
  - `gridOperatorId` string
  - `gridOperatorBdew` string
  - `gridOperatorName` string
  - `reason` string, required
  - `includeCapacityCheck` boolean
  - `correlationId` string
  - `idempotencyKey` string
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Grid connection validation draft proposal

- object
  - `draftId` string, required
  - `action` string, required
  - `target` object, required
    - `gridOperatorId` string, nullable
    - `gridOperatorBdew` string, nullable
    - `gridOperatorName` string, nullable
  - `proposedValidation` object, required: Parameters that would be passed to the consequential execute action
  - `summary` string, required
  - `confirmationMessage` string
  - `requiredConfirmation` boolean, required
  - `consequentialAction` object
  - `auditTrail` object, required

## Other responses

- `400`: No grid operator identifier supplied

---

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