Speicherlöschung

Vorläufiges Löschen (Soft Delete) ist der öffentliche Standard

DELETE /v1/memories/{memory_id} verwendet standardmäßig mode=soft_delete. POST /v1/memories/{memory_id}/forget akzeptiert dieselbe MemoryForgetRequest-Familie mit mode, reason, replacement_content und metadata. Ein Soft Delete erstellt einen Tombstone und einen Versions-Snapshot, setzt den Speicherstatus auf deleted und kann durch restore rückgängig gemacht werden.

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

Vergessen, Schwärzen und endgültiges Löschen sind unterschiedliche Modi

Die Persistenz-Engine unterstützt soft_delete, redact und hard_delete. Redact ersetzt Inhalte durch [REDACTED] (oder bereitgestellte Ersatzinhalte), bereinigt Metadaten sowie Embeddings und zeichnet eine sichere Schwärzungsherkunft auf. Hard Delete ist unwiderruflich und durch den strengeren Autorisierungspfad memory:hard_delete geschützt; wählen Sie diesen Modus nicht für routinemäßige Korrekturen.

• soft_delete — wiederherstellbare Löschung mit einem Tombstone und Versions-Snapshot.
• redact — Beibehaltung eines inhaltlosen Tombstones/Ergebnisses bei gleichzeitiger Entfernung des ursprünglichen Inhalts und Embeddings.
• hard_delete — dauerhafter Löschpfad, der die weitergehende Löschberechtigung erfordert.

Nur vorläufig gelöschte Erinnerungen wiederherstellen

POST /v1/memories/{memory_id}/restore akzeptiert MemoryRestoreRequest mit einer optionalen Begründung und Metadaten. Der Persistenzpfad setzt status=active wieder her und erhöht die Version; eine geschwärzte Erinnerung kann nicht wiederhergestellt werden, da ihr ursprünglicher Inhalt nicht mehr vorhanden ist.

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

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

Löschungen sind autorisiert und auditiert

Der REST-Änderungspfad prüft den modusspezifischen Speicher-Geltungsbereich und den eigentümerbezogenen Schlüssel vor Auflösung des Ziels. Er schreibt Speicher-Tombstone-/Audit-Nachweise mit dem angeforderten Modus, dem Vorhandensein einer Begründung und Zielreferenzen, ohne den vergessenen Inhalt preiszugeben.