---
title: "Prepare VDMI evidence injection intent — no write"
method: POST
path: "/api/copilot-process/vdmi/:matrixId/intents/evidence"
tags: ["Copilot Process"]
---

# Prepare VDMI evidence injection intent — no write

`POST /api/copilot-process/vdmi/:matrixId/intents/evidence`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/copilot-process/vdmi/:matrixId/intents/evidence`
- Auth: none declared

Verifies the VDMI matrix exists and creates a persistent ProcessExecutionIntent for evidence injection. No evidence is written.
Returns intentId, expiresAt, and confirmationMessage. Execute via executeProcessIntent outside Copilot.

## Query parameters

- `token` string

## Request body

- object
  - `matrixId` string, required
  - `evidenceType` string, required
  - `reference` string, required
  - `reason` string, required
  - `content` object: Optional additional content payload
  - `correlationId` string
  - `idempotencyKey` string
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

VDMI evidence intent created

- object
  - `intentId` string, required
  - `operationFamily` string, required
  - `proposedAction` string, required
  - `target` object
  - `inputSummary` string
  - `status` string, required
  - `expiresAt` string
  - `risk` string
  - `requiresHumanConfirmation` boolean, required
  - `summary` string
  - `confirmationMessage` string
  - `executeVia` object
  - `auditTrail` object

## Other responses

- `404`: Matrix not found

---

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