SDK ReferenceGraphEpisode

Update Episode Metadata

Update episode metadata with merge semantics. Supplied keys overwrite or add to existing metadata; keys set to null are removed.

Path parameters

uuidstringRequired
Episode UUID

Request

Metadata update
metadatamap from strings to anyRequired

Updated metadata. Merged with existing metadata: supplied keys overwrite/add, keys set to null are removed. Maximum 10 keys. Values must be scalars (string, number, boolean, null) or arrays of scalars.

Response

Updated episode
contentstring
created_atstring
uuidstring
metadatamap from strings to anyOptional
processedbooleanOptional
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).

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

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

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.

sourceenumOptional
source_descriptionstringOptional
task_idstringOptional
Optional task ID to poll episode processing status. Currently only available for batch ingestion.
thread_idstringOptional
Optional thread ID, will be present if the episode is part of a thread

Errors

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