SDK ReferenceGraphThread Summaries

Get User Thread Summaries

Returns incremental thread summaries generated from messages in each thread associated with the user's graph.

Path parameters

user_idstringRequired
User ID

Request

Pagination parameters
cursorstringOptional

Opaque cursor for pagination, obtained from the Zep-Next-Cursor response header of the previous page. Encodes the sort field, direction, and continuation position.

directionstringOptional

Sort direction. One of “asc” or “desc” (default “desc”).

filtersobjectOptional
Optional filters applied to the listed artifacts. Reuses the graph.search filter type.
limitintegerOptional
Maximum number of items to return
order_bystringOptional

Field to sort by. One of “created_at” or “uuid” (default “uuid”).

uuid_cursorstringOptional

UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page.

Deprecated: prefer Cursor, the opaque cursor returned via the Zep-Next-Cursor response header.

Response headers

Zep-Next-Cursorstring

Opaque cursor for the next page of results; absent when there are no more results.

Response

Thread summaries
created_atstring
CreatedAt is when the summary node was first created.
last_summarized_atstring

LastSummarizedAt is the wall-clock timestamp of the most recent summary update. This is an ingestion-time watermark; for the event-time recency of the summary’s content, use LastSummarizedEpisodeValidAt instead.

last_summarized_episode_valid_atstring

LastSummarizedEpisodeValidAt is the maximum episode reference time (valid_at) covered by the most recent summary. Use this when answering “how recent is this summary’s content in event-time?”.

summarystring
Summary is the incremental summary content.
thread_idstring

ThreadID is the ID of the thread this summary belongs to. When a thread was created without an explicit thread_id, this field falls back to the thread’s UUID. Clients should treat it as an opaque identifier.

uuidstring
UUID of the thread summary node.

Errors

400
Bad Request Error
404
Not Found Error
500
Internal Server Error