For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Type "Api-Key" followed by a space and the project API key.
Path parameters
graph_uuidstringRequired
Graph UUID
episode_uuidstringRequired
Episode UUID
Request
Request body
metadataobject or nullOptional
Metadata to merge onto the episode; a key set to null is removed. Max 10 keys after the merge. Values must be strings, numbers, booleans, or arrays of scalars.
Response
OK
contentstringOptional
The raw content of the episode.
content_policyobjectOptional
The content policy state of the episode, present only on a graph with a
bound content policy rule.
created_atstringOptional
The time the episode was created.
document_idstringOptional
The developer-assigned identifier of the document this episode belongs to,
present only for episodes added to a document.
graph_uuidstringOptional
The unique identifier of the graph this episode belongs to.
metadatamap from strings to anyOptional
Custom metadata associated with the episode.
processedbooleanOptional
Whether the episode has finished graph extraction and indexing.
relevancedoubleOptional
A cross-encoder-derived relevance score, present only when the
cross-encoder reranker scored this result; like score, it is omitted from
plain list results.
roleenumOptional
The role of the episode's sender, present only when the episode was added
as a message.
Allowed values:
role_namestringOptional
The free-form display name of the episode's sender, present only when the
episode was added as a message.
scoredoubleOptional
The ranking score returned with every search result; omitted when the
episode appears in a plain list rather than a search result.
sourceenumOptional
The format of the episode's content: text, json, or message.
Allowed values:
source_descriptionstringOptional
A free-form description of where the episode's content came from.
thread_uuidstringOptional
The thread this episode belongs to, present only for episodes added to a
thread.
uuidstringOptional
The unique identifier of the episode.
valid_atstringOptional
The time the episode's content became true or was observed, used for
temporal reasoning.
