メモリ削除

soft deletionが公開デフォルトです

DELETE /v1/memories/{memory_id}のデフォルトはmode=soft_deleteです。POST /v1/memories/{memory_id}/forgetは、mode、reason、replacement_content、metadataを持つ同じMemoryForgetRequest familyを受け付けます。Soft deleteは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は異なるmodeです

永続化engineはsoft_delete、redact、hard_deleteを受け付けます。Redactはcontentを[REDACTED]（または指定されたreplacement content）に置き換え、metadataとembeddingを消去し、安全なredaction provenanceを記録します。Hard deleteは不可逆で、より強いmemory:hard_delete authorization pathによって保護されています。通常の修正で選ばないでください。

• soft_delete — tombstoneとversion snapshotを伴う、復元可能な削除。
• redact — 元のcontentとembeddingを除去し、非contentのtombstone/resultだけを残す処理。
• hard_delete — より強いdelete capabilityを必要とする、恒久的な削除path。

soft-deleted memoryだけをrestoreする

POST /v1/memories/{memory_id}/restoreは、任意のreasonとmetadataを持つMemoryRestoreRequestを受け付けます。永続化pathはstatus=activeに戻してversionを増分します。Redacted memoryは元のcontentが残っていないためrestoreできません。

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

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

削除は認可され、監査される

REST mutation pathは、targetを解決する前にmodeごとのmemory scopeとowner-scoped keyを確認します。要求されたmode、reasonの有無、target referenceをmemory tombstone/audit evidenceに記録しますが、忘れられたcontentを公開結果に含めることはありません。