---
title: "Gap Insights"
method: GET
path: "/v1/insights/gaps"
tags: ["insights"]
---

# Gap Insights

`GET /v1/insights/gaps`

## 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/gaps`
- Auth: HTTP bearer

## Query parameters

- `include_proposed` boolean

## Response `200`

Successful Response

- GapsInsightResponse: GET /v1/insights/gaps — bridging questions, advisory only.
  - `gaps` GapQuestion[], required
    - `cluster_a_ids` string[], required
    - `cluster_b_ids` string[], required
    - `cluster_a_paths` string[], required
    - `cluster_b_paths` string[], required
    - `bridge_memory_id` string, uuid, nullable
    - `question` string, required
  - `message` string, nullable

## 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)