Copilot Process

Prepare VDMI matrix nomination — draft only, no write

Analyses the VDMI matrix and returns a draft nomination proposal. No writes: This action creates no persisted state. The returned draft must be explicitly confirmed by a consequential execute action (Phase 3).

Set requiredConfirmation: true in the response means Copilot must ask the user to confirm before proceeding.

post/api/copilot-process/vdmi/:matrixId/prepare-validation

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/copilot-process/vdmi/:matrixId/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

matrixIdstring required

VDMI matrix ID

reasonstring required

Business reason for the nomination

correlationIdstring

Caller-supplied trace ID for audit logging

idempotencyKeystring

Prevents duplicate submissions on retries

tokenstring

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

Example request

{
  "matrixId": "vdmi-abc123",
  "reason": "Netzanschluss fristgerecht abgeschlossen",
  "correlationId": "req-2026-001",
  "idempotencyKey": "idem-abc123-20260611"
}

Response

Draft nomination proposal

draftIdstring required

Unique ID of this draft

actionstring required
warningIfAnystring nullable
summarystring required
confirmationMessagestring
requiredConfirmationboolean required
readyToExecuteboolean

Example response

{
  "action": "nominate_vdmi_matrix",
  "requiredConfirmation": true,
  "consequentialAction": {
    "operationId": "executeVdmiNomination"
  }
}

Changes

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