Get the memory timeline

Recently active entities first — one card per entity, not per fact.

Each item is one entity with its humanized summary as the body and its connected edge facts inlined (for an "N facts" disclosure). Designed for user-facing memory browsers (Memories tab, infinite scroll). Prefer this over /memories/{agent_id} (which is relevance-ranked, capped at 50, and not paginated).

Query params:

agent_id: optional, scope to one agent. Cross-agent when omitted.
limit: 1-200, default 20.
cursor: ISO datetime from the previous page's next_cursor.
sort:
- last_updated (default) — entities ordered by max(edge.created_at); new facts make an entity pop to the top.
- created — entities ordered by their own creation time.

Namespace feeds (graph_id) require a service token.

GET

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

View as Markdown

Authorization

HTTPBearerHTTPrequired

Query parameters

agent_idoptional
One of the following:
string
null
}
graph_idoptional
Optional. Feed from 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: 20
cursoroptional
Optional. Opaque keyset cursor: pass back the previous page's next_cursor verbatim to get the next page. Format is '|' — the id half is what keeps entities sharing a timestamp from being skipped, so do not truncate it. Malformed values return 400 VALIDATION_ERROR. There is no offset/page parameter — this is the only pagination mechanism.
One of the following:
string
null
}
sortoptionalstring
pattern: ^(last_updated|created)$ · default: "last_updated"
visibilityoptional
Optional. Narrow the feed to entities with this visibility. Omit for the whole feed. Every item reports its own 'visibility' either way.
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

itemsarray ofobjectrequired
- idstringrequired
- namestringrequired
- labelsarray ofstringrequired
  Entity types; never empty.
- visibilityprivateorpublicrequired
- summarystringrequired
- summary_rawstringrequired
- first_seen_atrequired
  One of the following:
  string
  null
- last_updated_atrequired
  One of the following:
  string
  null
- fact_countintegerrequired
- factsarray ofobjectrequired
  idrequired
  One of the following:
  string
  null
  labelstringrequired
  factstringrequired
  created_atrequired
  One of the following:
  string
  null
  valid_atrequired
  One of the following:
  string
  null
  directionoutgoingorincomingrequired
  otherobjectrequired
  The entity at the other end of the fact.
  
  idrequired
  One of the following:
  string
  null
  namestringrequired
  labelsarray ofstringrequired
}
next_cursorrequired
Null on the last page.
One of the following:
string
null
}
sortlast_updatedorcreatedrequired

422

Validation Error

JSON

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

{ "items": [ { "id": "string", "name": "string", "labels": [ "string" ], "visibility": "private", "summary": "string", "summary_raw": "string", "first_seen_at": "string", "last_updated_at": "string", "fact_count": 0, "facts": [ { "id": "string", "label": "string", "fact": "string", "created_at": "string", "valid_at": "string", "direction": "outgoing", "other": { "id": "string", "name": "string", "labels": [ "string" ] } } ] } ], "next_cursor": "string", "sort": "last_updated" }