epistemic_explain

Trace the full lifecycle of a memory — from initial storage through every confidence change.

QUERY

epistemic_explain

Parameters

Name	Type	Required	Description
`id`	`string`	No*	Memory ID to explain.
`query`	`string`	No*	Natural language — explains the best matching memory.

*One of id or query is required.

Example

Response

{
  "memory": {
    "id": "mem_f8a2b1c3",
    "claim": "User works at Google",
    "confidence": 0.780,
    "tier": "CHALLENGED"
  },
  "history": [
    { "event": "STORE", "confidence": 0.780, "at": "2026-01-10T08:00:00Z" },
    { "event": "RECALL", "confidence": 0.780, "at": "2026-01-12T14:30:00Z" },
    { "event": "CHALLENGED", "by": "mem_d4e5f6", "at": "2026-01-15T10:30:00Z" }
  ],
  "conflicts": [
    { "id": "mem_d4e5f6", "claim": "User switched to Meta", "confidence": 0.780 }
  ]
}