CYA Agent

Generate profile-aware narrative

Runs the full CYA pipeline: data retrieval, deterministic regulatory graph, grounding, and LLM synthesis. Returns Option-B response structure.

post/api/cya/generate

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/cya/generate
  • 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

profile_idstring required
target_audiencestring required
perspectivesstring[] nullable

Enable multi-agent orchestration mode with stakeholder perspectives. If omitted, defaults to classic single-agent v0.26.8 behavior.

session_idstring nullable
tokenstring

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

Example request

{
  "profile_id": "stadtwerk_regulierung",
  "target_audience": "Aufsichtsrat",
  "perspectives": [
    "technical",
    "commercial"
  ],
  "context": {
    "location": "Ludwigshafen",
    "trigger": "Presseanfrage zur Netzstabilität",
    "focus_areas": [
      "capacity",
      "compliance",
      "nova"
    ]
  },
  "session_id": "cya_1713110400000"
}

Response

Pipeline result (internal/direct calls only; external callers receive 202)

successboolean
session_idstring
status'completed' | 'needs_clarification'
profile_idstring
target_audiencestring
groundingobject
regulatory_graphobject
clarificationobject nullable
metadataobject

Example response

{
  "success": true
}

Changes

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