Skip to content
UPG is in early alpha. The specification is still evolving and may change between versions.
Tools/Nodes/batch_delete_nodes

batch_delete_nodes

Delete up to 50 entities and their connected edges in one atomic call (all succeed or all fail).

Nodesatomic. Validation pass rejects the entire batch before any mutation lands.

Arguments

node_idsarrayrequired

Array of node IDs to delete (max 50)

expect_productstringoptional

Optional guard: abort if the active product is not this id/title/file.

Returns

Shape
{ deleted, edges_removed, count }

Examples

Live call against the Notion example graph.

Input

{
  "node_ids": [
    "1c051617-6cb7-4a59-b0a1-7779f404145b"
  ]
}

Output

{
  "deleted": [
    {
      "id": "1c051617-6cb7-4a59-b0a1-7779f404145b",
      "title": "Real-time multi-cursor collaboration"
    }
  ],
  "edges_removed": 10,
  "count": 1
}

See Also