For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
PlaygroundDiscordStatusDashboardSign Up >
DocumentationSDK ReferenceGraphiti
DocumentationSDK ReferenceGraphiti
  • SDK Reference
      • PUTSet graph ontology
      • GETList graph ontology
      • POSTAdd Data
      • POSTAdd Data in batch mode
      • POSTAdd Fact Triple
      • POSTClone graph
      • POSTCreate Graph
      • GETList all graphs.
      • POSTDetect Patterns (Experimental)
      • POSTSearch Graph
      • GETGet Graph
      • DELDelete Graph
      • PATCHUpdate Graph.
      • GETWarm Graph Cache
        • POSTGet Graph Observations
        • POSTGet User Observations
        • GETGet Observation
LogoLogo
PlaygroundDiscordStatusDashboardSign Up >
SDK ReferenceGraphObservations

Get Observation

GET
https://api.getzep.com/api/v2/graph/observation/:uuid
GET
/api/v2/graph/observation/:uuid
1from zep_cloud import Zep
2
3client = Zep(
4    api_key="YOUR_API_KEY",
5)
6client.graph.observation.get(
7    uuid_="uuid",
8)
1{
2  "created_at": "string",
3  "name": "string",
4  "uuid": "string",
5  "attributes": {},
6  "end_at": "string",
7  "episode_ids": [
8    "string"
9  ],
10  "labels": [
11    "string"
12  ],
13  "latest_evidence_at": "string",
14  "relevance": 1.1,
15  "score": 1.1,
16  "selection_rank": 1,
17  "start_at": "string",
18  "summary": "string"
19}

Returns a specific observation node by UUID. Observation nodes are read-only.

Was this page helpful?
Previous

Get Graph Thread Summaries

Next
Built with

Path parameters

uuidstringRequired
Observation UUID

Response

Observation
created_atstring
Creation time of the node
namestring
Name of the node
uuidstring
UUID of the node
attributesmap from strings to any
Additional attributes of the derived node.
end_atstring

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 strings
Episode UUIDs that support this observation. Only populated for observation nodes in web API responses.
labelslist of strings
Labels associated with the node
latest_evidence_atstring

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

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

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.

start_atstring

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

summarystring
Region summary of member nodes

Errors

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