SDK ReferenceGraph

Add Data

Add data to the graph.

Request

Add data request
datastringRequired
typeenumRequired
Allowed values:
created_atstringOptional
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.

source_descriptionstringOptional<=500 characters
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 episode
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