---
title: "Graph Insights"
method: GET
path: "/v1/insights/graph"
tags: ["insights"]
---

# Graph Insights

`GET /v1/insights/graph`

## Request

- Base URL: `https://api.heirmos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.heirmos.com/v1/insights/graph`
- Auth: HTTP bearer

## Query parameters

- `include_proposed` boolean

## Response `200`

Successful Response

- GraphInsightResponse: GET /v1/insights/graph — on-demand, read-only, nothing persisted.
  - `clusters` ClusterInfo[], required
    - `cluster_id` integer, required
    - `memory_ids` string[], required
    - `paths` string[], required
    - `size` integer, required
  - `bridges` BridgeInfo[], required
    - `memory_id` string, uuid, required
    - `path` string, nullable
    - `title` string, nullable
    - `score` number, required
  - `gap_pairs` GapPair[], required
    - `cluster_a` integer, required
    - `cluster_b` integer, required
    - `bridge_memory_id` string, uuid, nullable
  - `node_count` integer, required
  - `edge_count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/heirmos/apis/heirmos-api.md) · [All operations](https://skmtc.dev/heirmos/apis/heirmos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heirmos/apis/heirmos-api/revisions/ed490b1866e7?raw)