Get Episode

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

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