Sign in
latestOpenAPI 3.0.32026-08-227451,2751.8 MB

d0fc0114da66

KnowledgeGraph

Update a knowledge graph edge

Updates mutable fields of a knowledge graph edge (ordinal, weight, description, properties). Immutable fields (source_node_id, destination_node_id, label, created_at) are rejected with 400. Mandatory If-Match header. source_node_id is required for PK-aligned lookup.

patch/knowledgeGraph/edges/{edge_id}

Path parameters

edge_idstring required

The ID of the edge to update

Query parameters

workspace_idstring required

The workspace ID (required for auth scope)

application_idstring

The application ID (required for auth scope)

source_node_idstring required

The source node ID (required for PK-prefix-aligned lookup)

Headers

If-Matchstring

ETag for optimistic locking. Functionally required: omitting it surfaces a typed 428 (Precondition Required) response with code "etag_required" so an agent can recover deterministically. Declared as required=false at the schema level so the request reaches the service rather than being rejected by the OpenAPI validator with a generic 400.

Request body

ordinalinteger

Updated ordering hint (preserves existing value if absent or null)

weightnumber double

Updated edge weight (preserves existing value if absent or null)

descriptionstring

Updated relationship description (preserves existing value if absent or null)

propertiesobject

Updated additional structured properties (preserves existing value if absent or null)

agent_typestring

Agent type performing the update (preserves existing value if absent or null)

agent_versionstring

Agent version performing the update (preserves existing value if absent or null)

Response

The updated 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