Skip to content

Memory Expiration — Short and Long Term Fresh

Implement time-based memory expiration for short-term and long-term storage patterns.

Short-Term Memory

python
from datetime import datetime, timedelta

expiration = (datetime.now() + timedelta(days=7)).strftime("%Y-%m-%d")
client.add(
    messages, user_id="alice",
    expiration_date=expiration,
    metadata={"memory_type": "short_term"}
)

Long-Term Memory

Omit expiration_date for permanent storage:

python
client.add(messages, user_id="alice", metadata={"memory_type": "long_term"})

Best Practices

  • Use short expiry for session context, temporary states
  • Use long-term for preferences, goals, personal facts
  • Tag with metadata for easy filtering and cleanup

SOP Documentation Site for Mem0