Run the memory lifecycle pipeline — decay, prune, and compress memories to keep your knowledge graph sharp.
Fetch the complete documentation index at: https://docs.bsyncs.com/llms.txt
Use this file to discover all available pages before exploring further.
/brain/consolidateRuns the full memory lifecycle pipeline for your account:
Consolidation runs automatically every hour in the background. Call this endpoint manually only when you want to force an immediate cleanup — for example, after a large batch ingestion.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
persona | string | null | Restrict consolidation to a specific persona. | |
force | bool | false | Force consolidation even if it ran recently. |
| Field | Type | Description |
|---|---|---|
memories_decayed | int | Relationships whose confidence was reduced by the forgetting curve. |
memories_pruned | int | Relationships and episodic chunks deleted for falling below threshold. |
memories_compressed | int | Individual facts merged into cluster abstractions. |
abstractions_created | int | New higher-level summary nodes created in the knowledge graph. |
latency_ms | float | Total time in milliseconds. |
POST /brain/pruneIf you only want to remove low-confidence memories without running decay or compression:
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
threshold | float | 0.05 | Confidence below which memories are pruned. | |
dry_run | bool | true | If true, returns the count without deleting anything. | |
persona | string | null | Restrict pruning to a persona. |
dry_run: true first:Atlas uses the Ebbinghaus forgetting curve: R = e^(-t/S), where:
DECAY_HALF_LIFE_DAYS / ln(2)With the default DECAY_HALF_LIFE_DAYS=7, a memory not accessed for:
| Days elapsed | Confidence multiplier |
|---|---|
| 1 day | ~0.91× |
| 7 days | ~0.50× |
| 14 days | ~0.25× |
| 30 days | ~0.05× (prunable) |
Memories that are frequently retrieved resist decay — each access resets the clock and reinforces the access_count frequency score.
Run immediately after importing bulk historical data to prune noise and build abstractions.
Keep your knowledge graph clean and high-confidence for production agents.
Clear out stale context before starting a new development sprint with your agent.