SDK ReferenceGraphObservations

Get Graph Observations

Returns read-only observation nodes for a graph.

Path parameters

graph_idstringRequired
Graph 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”, “valid_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-CursorstringOptional

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

Response

Observations
created_atstring
Creation time of the node
namestring
Name of the node
uuidstring
UUID of the node
attributesmap from strings to anyOptional
Additional attributes of the derived node.
end_atstringOptional

EndAt is the close timestamp of the evidence window. Set when the underlying pattern is no longer supported (closed observations); nil for active observations.

episode_idslist of stringsOptional
Episode UUIDs that support this observation. Only populated for observation nodes in web API responses.
labelslist of stringsOptional
Labels associated with the node
latest_evidence_atstringOptional

LatestEvidenceAt is the most recent source-episode timestamp from which this observation drew evidence.

relevancedoubleOptional

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).

scoredoubleOptional

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

selection_rankintegerOptional

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

start_atstringOptional

StartAt is the earliest source-episode timestamp from which this observation was derived. Only populated for observation nodes.

summarystringOptional
Region summary of member nodes

Errors

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