Get Episode | Zep Documentation

Returns episodes by UUID

Path parameters

uuidstringRequired

Episode UUID

Response

Episode

contentstring

created_atstring

uuidstring

metadatamap from strings to any

processedboolean

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

rolestring

Optional role, will only be present if the episode was created using memory.add API

role_typeenum

Optional role_type, will only be present if the episode was created using memory.add API

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.

sourceenum

Allowed values:

source_descriptionstring

task_idstring

Optional task ID to poll episode processing status. Currently only available for batch ingestion.

thread_idstring

Optional thread ID, will be present if the episode is part of a thread

Errors

400

Bad Request Error

500

Internal Server Error

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

Optional role, will only be present if the episode was created using memory.add API

Optional role_type, will only be present if the episode was created using memory.add API

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

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

Optional task ID to poll episode processing status. Currently only available for batch ingestion.

Optional thread ID, will be present if the episode is part of a thread

1	from zep_cloud import Zep
2
3	client = Zep(
4	api_key="YOUR_API_KEY",
5	)
6	client.graph.episode.get(
7	uuid_="uuid",
8	)

1	{
2	"content": "string",
3	"created_at": "string",
4	"uuid": "string",
5	"metadata": {},
6	"processed": true,
7	"relevance": 1.1,
8	"role": "string",
9	"role_type": "norole",
10	"score": 1.1,
11	"selection_rank": 1,
12	"source": "text",
13	"source_description": "string",
14	"task_id": "string",
15	"thread_id": "string"
16	}

1	from zep_cloud import Zep
2
3	client = Zep(
4	api_key="YOUR_API_KEY",
5	)
6	client.graph.episode.get(
7	uuid_="uuid",
8	)

1	{
2	"content": "string",
3	"created_at": "string",
4	"uuid": "string",
5	"metadata": {},
6	"processed": true,
7	"relevance": 1.1,
8	"role": "string",
9	"role_type": "norole",
10	"score": 1.1,
11	"selection_rank": 1,
12	"source": "text",
13	"source_description": "string",
14	"task_id": "string",
15	"thread_id": "string"
16	}