---
title: "Generate multi-perspective comparison from profiles/templates"
method: POST
path: "/api/cya/compare-perspectives"
tags: ["CYA Agent"]
---

# Generate multi-perspective comparison from profiles/templates

`POST /api/cya/compare-perspectives`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/cya/compare-perspectives`
- Auth: none declared

Runs phases 1–3 once (retrieval/graph/grounding) and executes phase 4 synthesis in parallel for 2–5 profile IDs or template IDs.

## Query parameters

- `token` string

## Request body

- object
  - `profile_ids` string[], required
  - `target_audience` string, required
  - `context` object, required
    - `location` string, nullable
    - `trigger` string, required
    - `focus_areas` string[], required
    - `capacity_mw` number, nullable: Optional asset capacity in MW for topology-hop logic.
  - `session_id` string, nullable
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Comparison result

- object
  - `success` boolean
  - `session_id` string
  - `status` 'completed' | 'needs_clarification'
  - `perspectiveCount` number
  - `grounding` object
  - `regulatory_graph` object
  - `perspectives` object[]
  - `metadata` object

## Other responses

- `404`: Profile/template 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)