v1

latestOpenAPI 3.1.0BUSL-1.12026-07-1756132288.0 KB

Semantic forget: finds matching memories by similarity and soft-deletes them

post/api/v1/{context_id}/forget

Path parameters

context_idstring required

Spectron context id

Request body

dryRunboolean

When true, the handler computes and returns the would-be deletion count (deleted) without writing anything — the preview side of a preview-then-confirm flow. When omitted or false, matching memories are soft-deleted immediately.

purgeboolean

Phase 10.7 — right-to-be-forgotten. When true, the handler also removes the supersession history (rows with valid_until set) that match the same scope/entity criteria. When omitted or false, prior rows are retained for audit even after the current row is soft-deleted.

querystring required

Response

deletedinteger required