Memory

hm_get_overview

See the shape of a memory graph and which organizations you belong to

hm_get_overview returns a quick picture of a memory graph: how many nodes, edges, hyperedges and files it holds, which node types it uses, and when it was last written. Agents call it at the start of a conversation, together with hm_recall.

It also lists the organizations you belong to, which is how an agent learns which organization_id values it can use.

Parameters

ParameterTypeDescription
organization_idstringDescribe an organization graph you belong to instead of your own. Omit it, or send "none", for your own graph.

Response

FieldDescription
nodes, edges, hyperedges, filesTotals for the graph.
type_countsNumber of nodes per node type.
typesThe node types currently in use.
last_write_atWhen the graph was last written.
organizationsThe organizations you belong to, each with organization_id and name. Absent when you belong to none.

Example

{
  "nodes": 1240,
  "edges": 3315,
  "hyperedges": 212,
  "files": 14,
  "type_counts": { "fact": 402, "decision": 118, "person": 57 },
  "last_write_at": "2026-10-20T09:12:03Z",
  "organizations": [
    { "organization_id": "org_8c1f2a90d4e34b7f9a6e0c5b21d7f3aa", "name": "Acme" }
  ]
}

Equivalents

curl https://api.hypermemory.io/api/v1/memory/overview \
  -H "Authorization: Bearer $HYPERMEMORY_API_KEY"