EmpezarGuíasEliminación de memoria

Concept

Eliminación de memoria

Elija la ruta forget recuperable o un modo destructivo autorizado explícitamente, con un tombstone auditable.

La eliminación temporal es el valor predeterminado público

DELETE /v1/memories/{memory_id} usa por defecto mode=soft_delete. POST /v1/memories/{memory_id}/forget acepta la misma familia MemoryForgetRequest con mode, reason, replacement_content y metadata. Una eliminación temporal crea un tombstone y una instantánea de versión, cambia el status de la memoria a deleted y puede seguirse de un restore.

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

Forget, redact y hard-delete son modos distintos

El motor de persistencia acepta soft_delete, redact y hard_delete. redact sustituye content por [REDACTED] (o por el replacement_content proporcionado), borra metadata y embeddings y registra provenance segura de redaction. hard_delete es irreversible y está protegido por la ruta de autorización más fuerte memory:hard_delete; no lo elija para una corrección rutinaria.

  • soft_delete — eliminación recuperable con una lápida y una instantánea de la versión.
  • redact — conserva una lápida o un resultado sin contenido al eliminar el content y el embedding originales.
  • hard_delete — eliminación permanente path que requiere la capacidad de eliminación más fuerte.

Restaure únicamente una memoria eliminada temporalmente

POST /v1/memories/{memory_id}/restore acepta MemoryRestoreRequest con reason y metadata opcionales. La ruta de persistencia restaura status=active e incrementa la versión; una memoria con redaction no se puede restaurar porque su content original ya no está disponible.

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

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

La eliminación está autorizada y auditada

La ruta de mutación REST comprueba el scope de memoria específico del modo y la clave con alcance del propietario antes de resolver el objetivo. Escribe evidencia de tombstone/auditoría de memoria con el mode solicitado, la presencia de reason y las referencias del objetivo, sin exponer el content olvidado.

Flujos de roles

Usuario de ChatGPT

Dale a ChatGPT acceso duradero a tus preferencias de XMemo, datos de proyecto, decisiones y TODOs sin pegar fichas bearer en un chat.

Guarde una nota de preferencia sintética o de proyecto, inicie un nuevo chat y luego pida a ChatGPT que la recuerde a través de XMemo antes de continuar el trabajo.

Copiloto / Codex desarrollador

Lleve decisiones de repo, convenciones de codificación, notas de corrección de errores e historial de tareas entre los agentes IDE y CLI.

Grabe una decisión de base de código o corrección de errores, y luego pida al siguiente agente IDE o CLI que recuerde el contexto XMemo relevante antes de editarlo.

Equipo / propietario del piloto de la empresa

Evalúe la memoria compartida con controles de cuenta, atribución de origen, flujos de trabajo export/delete y pruebas de configuración seguras para los revisores.

Haga que un miembro piloto guarde una memoria sintética del equipo, confirme la atribución de origen en XMemo, luego revise delete/export y las rutas de soporte.

Fuente: API de memoria