lb_link_nodes

Creates typed edges from one source node to one or more target nodes. The write is a replace operation per link_type: all existing edges of that type from the source node are replaced with the new target set.

Parameters

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | source_node_id | string | Yes | ID of the source node (the edges originate here) | | target_node_ids | string[] | Yes | IDs of target nodes. Must contain 1–16 entries | | link_type | string | No | One of related, next, derived_from, supersedes, mentions, invokes. Default related |

Response

{
  "source_node_id": "...",
  "link_type": "related",
  "targets_set": 2
}

Errors

| Code | When | |------|------| | NOT_FOUND | source_node_id does not exist, or one or more targets do not exist in the current tenant |

Usage notes

• Replace semantics: calling lb_link_nodes(A, [B, C], "related") then lb_link_nodes(A, [D], "related") leaves A with only a single related edge to D. Other link_type values from A are untouched.
• target_node_ids is capped at 16 to stay under D1's parameter-bind limit.
• Edge writes are atomic: the DELETE of old edges and INSERT of new edges run in one db.batch() call.
• To append rather than replace, read the current edges via lb_get_related, merge client-side, then call lb_link_nodes with the merged set.