---
title: "Run Drift Now"
method: POST
path: "/api/v1/admin/bm25-drift/run"
tags: ["bm25-drift"]
---

# Run Drift Now

`POST /api/v1/admin/bm25-drift/run`

## 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/run`
- Auth: none declared

Manually trigger a drift measurement. Admin-only.

For dev/staging verification while the production cron is disabled
(v0.12.1 ships infrastructure-only; production enablement = v0.14.0).
Each requested context is enqueued as an `asyncio.create_task` and
runs against an independent DB session.

## Request body

- Bm25DriftRunRequest: Body for POST /admin/bm25-drift/run. Attributes: context_id: Target context. When null, runs against every active context (matches the cron behaviour). For dev/staging verification — production cron remains disabled until v0.14.0.
  - `context_id` string, uuid, nullable

## Response `202`

Successful Response

- Bm25DriftRunResponse
  - `scheduled_context_count` integer, 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)