Skip to main content
POST

Overview

Marks one memory expired. The memory keeps its content and remains recallable — it is simply labelled as no longer current, and stamped with when it expired and why. This is the reversible alternative to Delete Memory. See the Memory Lifecycle reference for the model.

Authentication

API clients do not send an API key or Authorization header.
string
required
Session token from Activate Agent. Must match agent_id.

Path Parameters

string
required
The unique identifier of the agent.
string
required
The ID of the memory to expire.

Body

string
default:"manual"
Why this memory expired, stamped as expired_by. Bounded to letters, digits, ., _ and - so it stays a usable filter token. The body may be omitted entirely to accept the default.

Notes

  • Content, tags, confidence and timestamps are untouched — this is a metadata-only rewrite.
  • status, expired_at and expired_by are always written together, so an expired memory always carries a when and a why.
  • Editing an expired memory via Edit Memory preserves the stamp; only Restore Memory clears it.
  • To retire memories in bulk by rule, use Apply Expiry Policy.

Next Steps