Add Data in batch mode
Add data to the graph in batch mode. Episodes are processed sequentially in the order provided.
Request
Add data request
episodes
graph_id
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_id
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
content
created_at
uuid
metadata
processed
relevance
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).
role
Optional role, will only be present if the episode was created using memory.add API
role_type
Optional role_type, will only be present if the episode was created using memory.add API
score
Score is the reranker output: sigmoid-distributed logits [0,1] when using cross_encoder reranker, or RRF ordinal rank when using rrf reranker
source
Allowed values:
source_description
task_id
Optional task ID to poll episode processing status. Currently only available for batch ingestion.
thread_id
Optional thread ID, will be present if the episode is part of a thread
Errors
400
Bad Request Error
500
Internal Server Error
