5.18 The get_memory tool

Fetches a single memory by id, including soft-deleted rows. Useful for inspecting one row surfaced by recall, list_memories, or as a near-duplicate candidate from remember, and for examining tombstone metadata (deleted_at, forget_reason, replaced_by_id) of a soft-deleted row.

5.18.1 Inputs

id

Required integer. The memory’s id.

5.18.2 Output

{
  "ok": true,
  "memory": {
    "id": 123,
    "text": "...",
    "tags": ["family"],
    "importance": 0.5,
    "created_at": "2026-05-05T12:00:00Z",
    "updated_at": "2026-05-05T12:00:00Z",
    "deleted_at": null,
    "forget_reason": null,
    "replaced_by_id": null,
    "last_confirmed_at": "2026-05-05T12:00:00Z",
    "expires_at": null,
    "source_provider": "openai"
  }
}

5.18.3 Errors

INVALID_INPUT, NOT_FOUND, DATABASE_ERROR.