---
title: "Reveal Drift Terms"
method: POST
path: "/api/v1/admin/bm25-drift/{row_id}/reveal-terms"
tags: ["bm25-drift"]
---

# Reveal Drift Terms

`POST /api/v1/admin/bm25-drift/{row_id}/reveal-terms`

## Request

- Base URL: `https://memory.kagura-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://memory.kagura-ai.com/api/v1/admin/bm25-drift/{row_id}/reveal-terms`
- Auth: none declared

Resolve mmh3-hashed term indices in top_divergent_terms to plaintext.

Reads pre-tokenized fields from the Qdrant payload (see
QDRANT_TOKEN_PAYLOAD_FIELDS) populated by memory_service, recomputes
mmh3 hashes via utils.sparse_vector.hash_token, and matches against
the stored indices. Falls back to re-tokenizing summary text only
for legacy points written before the token payload fields existed.
Streams Qdrant pages and breaks as soon as every requested hash is
resolved, so memory stays bounded for million-point contexts.
Rate-limited per user. Every terminal branch (success / 404 /
rate-limited) writes an AuditLog row; term content is never logged.

## Path parameters

- `row_id` integer, required

## Request body

- Bm25DriftRevealRequest: Body for POST /admin/bm25-drift/{row_id}/reveal-terms.
  - `reason` string, required: Justification for viewing plaintext terms (audit-logged)

## Response `200`

Successful Response

- Bm25DriftRevealResponse: Drift detail + resolved plaintext terms.
  - `id` unknown, required
  - `context_id` unknown, required
  - `context_name` unknown
  - `measured_at` unknown, required
  - `psi` unknown, required
  - `psi_status` unknown, required
  - `m_memory_points` unknown, required
  - `r_resource_points` unknown, required
  - `num_terms` unknown, required
  - `context_deleted` unknown
  - `top_divergent_terms` unknown
  - `resolved_terms` unknown, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud.md) · [All operations](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/revisions/09f17f5ada29?raw)