CYA Agent

Refine a generated narrative

Refines an existing CYA session with user feedback or clarification input (Option-B response structure).

post/api/cya/refine

Request

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

session_idstring required
user_feedbackstring nullable
agent_clarification_responsestring nullable
tokenstring

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

Example request

{
  "session_id": "cya_1713110400000",
  "user_feedback": "Bitte stärker auf §14a fokussieren",
  "agent_clarification_response": "Bitte Region auf Ludwigshafen eingrenzen",
  "clarification_response": {
    "provided_data": {
      "capacity": "Lokale PV-Durchdringung 8 MW, 10-MW-Speicher muss ans 110-kV-UW Meckesheim (Netze BW).",
      "redispatch": "Netzregion leidet unter §13a-Abregelungen von Wind/PV.",
      "nova": "Netze BW prüft Trafo-Ausbau, Flexibilität fehlt.",
      "investment": "Kommune Mauer will Gewerbesteuer sichern."
    }
  }
}

Response

Refinement result

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

Example response

{
  "success": true
}

Changes

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