---
title: "Run governed enrichment over a query's surfaced nodes"
method: POST
path: "/api/enrich"
---

# Run governed enrichment over a query's surfaced nodes

`POST /api/enrich`

Execute a Cypher query, detect declared-but-null property gaps on the
surfaced nodes, fill each with a single LLM call, and quarantine the result
under `_enrichment` with provenance. Honest-decline: an UNKNOWN answer writes
nothing. Promotion into the live property happens only at `/api/verify`.

## Request body

- object
  - `query` string, required — The Cypher query whose surfaced nodes are enriched.

## Response `200`

Enrichment completed

- object
  - `gaps` integer
  - `filled` integer
  - `declined` integer

## Other responses

- `400` — Query or enrichment error

## Changes

- **2026-08-22** `1af4d2b043ab` — 1 info
  - endpoint added
- **2026-08-22** `0caaf08c2f95` — 1 breaking
  - api path removed without deprecation
- **2026-08-22** `fc59d98a8ac3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/samyama-ai/apis/samyama-graph-database-api/changes/api/enrich/post.md)

---

[API](https://skmtc.dev/samyama-ai/apis/samyama-graph-database-api.md) · [All operations](https://skmtc.dev/samyama-ai/apis/samyama-graph-database-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/samyama-ai/samyama-graph-database-api/revisions/7f3d37bbc2cd/schema)