SUsurrealdb

POST /api/v1/{context_id}/forget

Changed on

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

Request

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

Changes