Nodes API

Base path

/graphs/{graphId}/nodes/{nodeType}

All node operations are scoped to a graph and a node type.
If the node type has not been registered in the schema, the request returns 404.

---

Create a node

POST /graphs/{graphId}/nodes/{nodeType}

Request body

{
  "id": "node_alice",
  "data": {
    "name": "Alice",
    "email": "alice@example.com"
  },
  "embedding": [0.021, -0.043, 0.102]
}

• id — optional; a unique ID is generated if omitted
• data — validated against the node type’s property schema
• embedding — optional; required for agentic queries

Response 201

{
  "id": "node_alice",
  "type": "Person",
  "data": { "name": "Alice", "email": "alice@example.com" },
  "createdAt": 1705312800000
}

---

Get a node

GET /graphs/{graphId}/nodes/{nodeType}/{nodeId}

---

Update a node

PATCH /graphs/{graphId}/nodes/{nodeType}/{nodeId}

Request body — partial update; only provided fields are changed.

{
  "data": { "email": "alice@new.example.com" }
}

---

Delete a node

DELETE /graphs/{graphId}/nodes/{nodeType}/{nodeId}

Deleting a node also removes all edges connected to it.

---

List nodes

GET /graphs/{graphId}/nodes/{nodeType}?limit=50&offset=0

Parameter	Default	Description
limit	50	Max nodes to return
offset	0	Pagination offset