SDK ReferenceGraph

Add Fact Triple

Add a fact triple for a user or group

Request

Triple to add
factstringRequired<=250 characters
The fact relating the two nodes that this edge represents
fact_namestringRequired1-50 characters

The name of the edge to add. Should be all caps using snake case (eg RELATES_TO)

created_atstringOptional
The timestamp of the message
edge_attributesmap from strings to anyOptional

Additional attributes of the edge. Values must be scalar types (string, number, boolean, or null). Nested objects and arrays are not allowed.

expired_atstringOptional

The time (if any) at which the edge expires

fact_uuidstringOptional
The uuid of the edge to add
graph_idstringOptional
invalid_atstringOptional

The time (if any) at which the fact stops being true

metadatamap from strings to anyOptional

Optional metadata key-value pairs for the shadow episode created for this fact triple. Max 10 keys. Values must be strings, numbers, or booleans.

source_node_attributesmap from strings to anyOptional

Additional attributes of the source node. Values must be scalar types (string, number, boolean, or null). Nested objects and arrays are not allowed.

source_node_labelslist of stringsOptional

The labels for the source node. At most one entity-type label may be provided so that manually-added triples remain consistent with automatic episode extraction, which assigns one best-match entity type per node. The base “Entity” label is added implicitly by the graph layer on save and does not need to be supplied here.

source_node_namestringOptional<=50 characters
The name of the source node to add
source_node_summarystringOptional<=500 characters
The summary of the source node to add
source_node_uuidstringOptional
The source node uuid
target_node_attributesmap from strings to anyOptional

Additional attributes of the target node. Values must be scalar types (string, number, boolean, or null). Nested objects and arrays are not allowed.

target_node_labelslist of stringsOptional

The labels for the target node. At most one entity-type label may be provided so that manually-added triples remain consistent with automatic episode extraction, which assigns one best-match entity type per node. The base “Entity” label is added implicitly by the graph layer on save and does not need to be supplied here.

target_node_namestringOptional<=50 characters
The name of the target node to add
target_node_summarystringOptional<=500 characters
The summary of the target node to add
target_node_uuidstringOptional
The target node uuid
user_idstringOptional
valid_atstringOptional
The time at which the fact becomes true

Response

Resulting triple
edgeobject
source_nodeobject
target_nodeobject
task_idstring
Task ID of the add triple task

Errors

400
Bad Request Error
500
Internal Server Error