Sign in
KnowledgeGraph

Create a knowledge graph edge

Creates a new directed edge between two nodes in the knowledge graph. Server generates the edge_id with suffix -kge. Validates that source and destination nodes exist in the same workspace. On duplicate (source, label, destination) returns 409 with the existing edge.

post/knowledgeGraph/edges

Request body

workspace_idstring required

The workspace to create the edge in

application_idstring

The application this edge is associated with (used for auth scope)

source_node_idstring required

The source node ID (must exist in same workspace)

destination_node_idstring required

The destination node ID (must exist in same workspace)

label'CONTAINS' | 'HAS_KNOWLEDGE' | 'DEPENDS_ON' | 'RELATED_TO' | 'COVERS' required

Label for a knowledge graph edge indicating its relationship type

ordinalinteger

Ordering hint for sibling edges

weightnumber double

Edge weight (0.0-1.0)

descriptionstring

Human-readable description of this relationship

propertiesobject

Additional structured properties

agent_typestring

Agent type creating this edge

agent_versionstring

Agent version creating this edge

Response

The created edge

edge_idstring

Unique identifier for the edge (server-generated, suffix -kge)

workspace_idstring

The workspace this edge belongs to

source_node_idstring

The source node ID

destination_node_idstring

The destination node ID

label'CONTAINS' | 'HAS_KNOWLEDGE' | 'DEPENDS_ON' | 'RELATED_TO' | 'COVERS'

Label for a knowledge graph edge indicating its relationship type

ordinalinteger

Ordering hint for sibling edges

weightnumber double

Edge weight (0.0-1.0)

descriptionstring

Human-readable description of this relationship

propertiesobject

Additional structured properties for this edge

versioninteger

Monotonic edit counter (server-managed, readOnly)

u_version_string

ETag for optimistic locking (server-managed, readOnly)

last_updated_bystring

Principal who last updated this edge (server-managed, readOnly)

created_bystring

Principal who created this edge (server-managed, readOnly)

agent_typestring

Agent type that wrote this edge

agent_versionstring

Agent version that wrote this edge

created_atstring date-time

Creation timestamp

updated_atstring date-time

Last update timestamp

Changes