Copilot Process

Generic Process Intake — creates a pending_confirmation intent, no write, no auto-execution

Separate contract from the read-only Evidence Router (POST /api/evidence-router/route). Accepts a generic, domain-agnostic process/write intent and creates a ProcessExecutionIntent in pending_confirmation status. Establishes the intake/classification/HITL boundary only — the created intent's operationFamily has no case in executeProcessIntent's dispatch table (_executeIntent), so it can never be auto-executed until a developer deliberately adds a reviewed, specific case. Rejects domain-reserved operationFamily values (use the dedicated prepare* action instead, e.g. prepareVdmiEvidence) and rejects proposedAction values that resolve to a registered read-only action (use the Evidence Router instead).

post/api/copilot-process/intents

Request

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

operationFamilystring required
proposedActionstring required
targetTypestring
targetIdstring
inputSummarystring
payloadobject

Arbitrary structured or semi-structured process data supplied by the user.

risk'low' | 'medium' | 'high'
reasonstring
correlationIdstring
decisionFrameIdstring
tokenstring

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

Example request

{
  "operationFamily": "customer_master_data_correction",
  "proposedAction": "correct_metering_point_address",
  "targetType": "meteringPoint",
  "targetId": "MP-12345"
}

Response

Process intake intent created (pending human confirmation)

Changes

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