Get Graph Edges | Zep Documentation

Returns all edges for a graph.

Path parameters

graph_idstringRequired

Graph ID

Request

Pagination parameters

limitintegerOptional

Maximum number of items to return

uuid_cursorstringOptional

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

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