Get memory graph for visualization

One graph for visualization: entity nodes plus their RELATES_TO facts.

Every entity with a live fact in scope appears, whatever produced it — a chat turn, an agent-tool write, or an API ingest of any type. source_description is a provenance label and never decides what is shown, and no entity type is hidden. Episodes are not nodes here; they stay stored verbatim and come back through GET /memories/export?include_episodes=true.

cursor paginates edges. Namespace views (graph_id) require a service token.

GET

https://truememory-api.mvstg.com/memories/graph

View as Markdown

Authorization

HTTPBearerHTTPrequired

Query parameters

agent_idoptional
One of the following:
string
null
}
graph_idoptional
Optional. Render a shared namespace instead of the user's own graph. Requires a service token; mutually exclusive with agent_id; no subject user needed.
One of the following:
string
null
}
limitoptionalinteger
maximum: 500 · minimum: 1 · default: 200
cursoroptional
Optional. Opaque keyset cursor over edges: pass back the previous page's next_cursor verbatim. Format is '|' — the id half is what keeps edges sharing a timestamp from being skipped, so do not truncate it. Malformed values return 400 VALIDATION_ERROR.
One of the following:
string
null
}
visibilityoptional
Optional. Narrow the graph to nodes with this visibility; an edge survives only when both its endpoints do. Omit for the full graph.
One of the following:
string
null
}

Header parameters

X-On-Behalf-Ofoptional
One of the following:
string
null
}
X-External-User-Idoptional
One of the following:
string
null
}
X-App-Idoptional
One of the following:
string
null
}

Returns

200

Successful Response

JSON

nodesarray ofobjectrequired
- idstringrequired
- namestringrequired
- summarystringrequired
  Humanized summary when available, else the raw one.
- summary_rawstringrequired
- labelsarray ofstringrequired
  Entity types; never empty.
- visibilityprivateorpublicrequired
- attributesobjectrequired
  Every other property the entity carries; keys vary by type.
- created_atrequired
  One of the following:
  string
  null
}
edgesarray ofobjectrequired
- idstringrequired
- sourcestringrequired
  Node id the fact starts from.
- targetstringrequired
  Node id the fact points to.
- labelstringrequired
- factstringrequired
- created_atrequired
  One of the following:
  string
  null
- valid_atrequired
  One of the following:
  string
  null
}
next_cursorrequired
Pass back as cursor for the next page of edges; null on the last page.
One of the following:
string
null
}

422

Validation Error

JSON

detailoptionalarray ofobject
- locarray ofrequired
  One of the following:
  string
  integer
- msgstringrequired
- typestringrequired
- inputoptionalunknown
- ctxoptionalobject
}

{ "nodes": [ { "id": "string", "name": "string", "summary": "string", "summary_raw": "string", "labels": [ "string" ], "visibility": "private", "attributes": {}, "created_at": "string" } ], "edges": [ { "id": "string", "source": "string", "target": "string", "label": "string", "fact": "string", "created_at": "string", "valid_at": "string" } ], "next_cursor": "string" }