Exclusão de memória

A exclusão lógica é o padrão público

DELETE /v1/memories/{memory_id} usa por padrão mode=soft_delete. POST /v1/memories/{memory_id}/forget aceita a mesma família MemoryForgetRequest, com mode, reason, replacement_content e metadata. Uma exclusão lógica cria um tombstone e um snapshot de versão, muda o status da memória para deleted e pode ser seguida de restauração.

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

Esquecer, redigir e excluir definitivamente são modos diferentes

O mecanismo de persistência aceita soft_delete, redact e hard_delete. Redact substitui o conteúdo por [REDACTED] (ou pelo conteúdo de substituição fornecido), limpa metadados e embeddings e registra uma proveniência segura de redação. Hard delete é irreversível e protegido pelo caminho de autorização mais forte memory:hard_delete; não o escolha como correção de rotina.

• soft_delete — exclusão recuperável com tombstone e snapshot de versão.
• redact — mantém um tombstone/resultado sem conteúdo enquanto remove o conteúdo original e o embedding.
• hard_delete — caminho de remoção permanente que exige a capacidade de exclusão mais forte.

Restaure apenas uma memória excluída logicamente

POST /v1/memories/{memory_id}/restore aceita MemoryRestoreRequest com reason e metadata opcionais. O caminho restaura status=active e incrementa a versão; uma memória redigida não pode ser restaurada porque seu conteúdo original não está mais disponível.

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

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

A exclusão é autorizada e auditada

O caminho de mutação REST verifica o escopo de memória específico do modo e a chave limitada ao proprietário antes de resolver o alvo. Ele grava evidências de tombstone/auditoria da memória com o modo solicitado, a presença do motivo e as referências do alvo, sem expor o conteúdo esquecido.