Skip to main content
POST
/
brain
/
consolidate
curl --request POST \
  --url https://api.atlas.bsyncs.com/brain/consolidate \
  --header 'X-API-Key: atlas_your_key_here' \
  --header 'Content-Type: application/json' \
  --data '{
    "user_id": "user-123"
  }'

{
  "memories_decayed": 24,
  "memories_pruned": 3,
  "memories_compressed": 8,
  "abstractions_created": 2,
  "latency_ms": 3100
}
Consolidation does not count against your monthly ops limit.

​
Authorizations

​
X-API-Key
string
required
Your Atlas API key. Format: atlas_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

​
Body

​
user_id
string
required
Namespace to consolidate. Overridden server-side from your API key.
​
force
boolean
default:"false"
Force consolidation even if it ran recently.
Use after a bulk ingest or data migration.

​
Response

​
memories_decayed
integer
Facts whose confidence score was reduced by Ebbinghaus decay.
​
memories_pruned
integer
Facts permanently deleted because their confidence dropped below threshold.
​
memories_compressed
integer
Facts merged into higher-order cluster abstractions by LLM compression.
​
abstractions_created
integer
New summary facts created from compressed clusters.
​
latency_ms
float
Total consolidation time. Typically 2–5 seconds depending on memory size.
curl --request POST \
  --url https://api.atlas.bsyncs.com/brain/consolidate \
  --header 'X-API-Key: atlas_your_key_here' \
  --header 'Content-Type: application/json' \
  --data '{
    "user_id": "user-123"
  }'

{
  "memories_decayed": 24,
  "memories_pruned": 3,
  "memories_compressed": 8,
  "abstractions_created": 2,
  "latency_ms": 3100
}