메모리 삭제

소프트 삭제가 공개 기본값입니다

DELETE /v1/memories/{memory_id}의 기본값은 mode=soft_delete입니다. POST /v1/memories/{memory_id}/forget은 mode, reason, replacement_content, metadata가 포함된 동일한 MemoryForgetRequest 계열을 받습니다. 소프트 삭제는 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 경로로 보호됩니다. routine correction에 선택하지 마세요.

• soft_delete — tombstone과 version snapshot이 있는 복구 가능한 삭제.
• redact — 원본 content와 embedding을 제거하면서 비-content tombstone/result를 남깁니다.
• hard_delete — 더 강한 delete capability가 필요한 영구 제거 경로.

소프트 삭제된 메모리만 복원하세요

POST /v1/memories/{memory_id}/restore는 선택적 reason과 metadata가 있는 MemoryRestoreRequest를 받습니다. persistence 경로는 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 경로는 target을 해석하기 전에 mode별 memory scope와 owner-scoped key를 확인합니다. 요청된 mode, reason 존재 여부 및 target reference를 담은 memory tombstone/audit evidence를 쓰되 잊힌 content는 노출하지 않습니다.