Copilot Process

Prepare grid connection validation config — draft only, no write

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.

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

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

gridOperatorIdstring
gridOperatorBdewstring
gridOperatorNamestring
reasonstring required
includeCapacityCheckboolean
correlationIdstring
idempotencyKeystring
tokenstring

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

Example request

{
  "gridOperatorId": "SNB935578300972",
  "gridOperatorBdew": "9907473000008",
  "gridOperatorName": "STROMDAO Netze",
  "reason": "Jahresprüfung Q2 2026",
  "correlationId": "req-2026-001",
  "idempotencyKey": "idem-stromdao-20260611"
}

Response

Grid connection validation draft proposal

draftIdstring required
actionstring required
proposedValidationobject required

Parameters that would be passed to the consequential execute action

summarystring required
confirmationMessagestring
requiredConfirmationboolean required
consequentialActionobject
auditTrailobject required

Example response

{
  "action": "run_grid_connection_validation",
  "requiredConfirmation": true
}

Changes

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