SDK ReferenceGraphEdge

Get User Edges

Returns all edges for a user.

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

Edges
created_atstring
Creation time of the edge
factstring
Fact representing the edge and nodes that it connects
namestring
Name of the edge, relation name
source_node_uuidstring
UUID of the source node
target_node_uuidstring
UUID of the target node
uuidstring
UUID of the edge
attributesmap from strings to any
Additional attributes of the edge. Dependent on edge types
episodeslist of strings
List of episode ids that reference these entity edges
expired_atstring
Datetime of when the node was invalidated
invalid_atstring
Datetime of when the fact stopped being true
relevancedouble

Relevance is an experimental rank-aligned score in [0,1] derived from Score via logit transformation. Only populated when using cross_encoder reranker; omitted for other reranker types (e.g., RRF).

scopestring

Scope of the edge (e.g. “entity”, “maybe_related”)

scoredouble

Score is the reranker output: sigmoid-distributed logits [0,1] when using cross_encoder reranker, or RRF ordinal rank when using rrf reranker

selection_rankinteger

SelectionRank is the global cross-scope rank assigned by auto scope selection.

valid_atstring
Datetime of when the fact became true

Errors

400
Bad Request Error
500
Internal Server Error