记忆删除

软删除是公开默认值

DELETE /v1/memories/{memory_id} 默认使用 mode=soft_delete。POST /v1/memories/{memory_id}/forget 接受同一 MemoryForgetRequest 系列参数，包括 mode、reason、replacement_content 和 metadata。软删除会创建 tombstone 与 version snapshot，将 memory status 改为 deleted，并且之后可以 restore。

DELETE /v1/memories/<memory-id>?mode=soft_delete&reason=user-requested
X-API-Key: <your-assigned-api-key>

forget、redact 和 hard-delete 是不同模式

persistence engine 接受 soft_delete、redact 和 hard_delete。Redact 会将 content 替换为 [REDACTED]（或提供的 replacement content），清除 metadata 与 embeddings，并记录安全的 redaction provenance。Hard delete 不可逆，并由更强的 memory:hard_delete authorization 路径保护；不要把它作为日常修正手段。

• soft_delete — 带 tombstone 和 version snapshot 的可恢复删除。
• redact — 移除原始 content 与 embedding，同时保留非 content 的 tombstone/result。
• hard_delete — 需要更强 delete capability 的永久移除路径。

只恢复软删除的记忆

POST /v1/memories/{memory_id}/restore 接受带有可选 reason 和 metadata 的 MemoryRestoreRequest。持久化路径会将 status 恢复为 active 并递增 version；redacted memory 无法恢复，因为其原始 content 已不可用。

POST /v1/memories/<memory-id>/restore
X-API-Key: <your-assigned-api-key>
Content-Type: application/json

{
  "reason": "owner-confirmed recovery"
}

删除经过授权并留下审计记录

REST mutation path 会在解析目标前检查特定模式的 memory scope 和 owner-scoped key。它会写入包含请求模式、reason 是否存在以及目标引用的 memory tombstone/audit evidence，但不会暴露已忘记的 content。