SDK ReferenceGraph

Add Data in batch mode

Add data to the graph in batch mode, processing episodes concurrently. Use only for data that is insensitive to processing order.

Request

Add data request
episodeslist of objectsRequired
graph_idstringOptional

graph_id is the ID of the graph to which the data will be added. If adding to the user graph, please use user_id field instead.

user_idstringOptional

User ID is the ID of the user to which the data will be added. If not adding to a user graph, please use graph_id field instead.

Response

Added episodes
contentstring
created_atstring
uuidstring
metadatamap from strings to any or null
processedboolean or null
relevancedouble or null

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 or null
Optional role, will only be present if the episode was created using memory.add API
role_typeenum or null

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

scoredouble or null

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

sourceenum or null
Allowed values:
source_descriptionstring or null
task_idstring or null
Optional task ID to poll episode processing status. Currently only available for batch ingestion.
thread_idstring or null
Optional thread ID, will be present if the episode is part of a thread

Errors