Suppression de mémoire

La suppression réversible est le choix par défaut public

DELETE /v1/memories/{memory_id} applique par défaut mode=soft_delete. POST /v1/memories/{memory_id}/forget accepte la même famille MemoryForgetRequest avec mode, reason, replacement_content et metadata. Une suppression réversible génère un marqueur d'effacement tombstone et un instantané de version, modifie le statut de la mémoire vers deleted et autorise une restauration ultérieure.

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

Forget, redact et hard-delete sont des modes distincts

Le moteur de persistance prend en charge soft_delete, redact et hard_delete. Redact remplace le contenu par [REDACTED] (ou par le texte de remplacement fourni), purge les métadonnées ainsi que les plongements, et consigne une provenance d'expurgation sécurisée. La suppression définitive hard_delete est irréversible et protégée par l'autorisation renforcée memory:hard_delete ; ne la choisissez pas pour une simple correction courante.

• soft_delete — suppression réversible accompagnée d'un marqueur d'effacement et d'un instantané de version.
• redact — conserve un résultat/marqueur sans contenu tout en éliminant le contenu d'origine et le plongement.
• hard_delete — suppression définitive et permanente requérant la capacité de suppression renforcée.

Restaurer uniquement une mémoire supprimée de manière réversible

POST /v1/memories/{memory_id}/restore accepte MemoryRestoreRequest avec un motif facultatif et des métadonnées. Le circuit de persistance rétablit status=active et incrémente la version ; une mémoire caviardée ne peut pas être restaurée car son contenu d'origine n'est plus accessible.

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

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

La suppression est autorisée et auditée

Le circuit de mutation REST contrôle le périmètre de mémoire propre au mode et la clé restreinte au propriétaire avant de résoudre la cible. Il enregistre les éléments d'audit et marqueurs de mémoire avec le mode demandé, la mention du motif et les références cibles sans jamais divulguer le contenu oublié.