Playground

Playground

Edge

/api/v1/graph/edges

A directed graph edge between two nodes.

listgetcreateupdatedelete

Schema

FieldTypeNotes
id*uuidServer-assigned ULID with type prefix (e.g. per_…).
tenant_id*stringTenant scope — auto-stamped from the caller's JWT.
app_idstringApp scope. Stamped ONLY when the caller's JWT was minted for a specific Application (integration API keys). Absent for human-user sessions. Filters reads when present.
created_at*date-timeServer stamp.
updated_at*date-timeServer stamp; updated on every patch.
created_byuuidPerson id from the caller's JWT (sub).
updated_byuuidPerson id from the last writer's JWT (sub).
sourcestringProvenance tag — defaults to 'edm'.
source_typeenumfrontend | backend | server | system | apiWhere the write originated. Defaults to 'api'.
is_deletedbooleanSoft-delete flag. Excluded from default list queries.
deleted_atdate-timeStamped when soft-deleted; null otherwise.
deleted_byuuidPerson id who soft-deleted; null otherwise.
schema_versionnumberDocument schema version. Bumped on incompatible writes.
source_id*stringSource node ID.
target_id*stringTarget node ID.
type*stringEdge type label (e.g., reports_to, owns, member_of).
propertiesjsonKey-value properties attached to the edge.
weightnumberEdge weight for weighted graph algorithms.
target_typestringEntity type name of the target entity (e.g., Person, TechnologyAsset).
relationship_typestringSemantic label describing the nature of this relationship (e.g., manages, owns, depends_on).
confidencenumberConfidence score (0.0-1.0) that this relationship is accurate; 1.0 is authoritative.

API

Loading manifest…