Data
Expire Memory
Retire a memory without deleting it.
POST
Overview
Marks one memoryexpired. 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 orAuthorization 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_atandexpired_byare 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
- Restore Memory to reverse this
- Recall with
status: "expired"to list expired memories