Edges API

Base path

/graphs/{graphId}/edges/{edgeType}

---

Create an edge

POST /graphs/{graphId}/edges/{edgeType}

Request body

{
  "id": "edge_alice_bob",
  "sourceId": "node_alice",
  "targetId": "node_bob",
  "data": { "since": "2024-01" }
}

• sourceId and targetId must refer to existing nodes
• data is validated against the edge type’s property schema

Response 201

{
  "id": "edge_alice_bob",
  "type": "KNOWS",
  "sourceId": "node_alice",
  "targetId": "node_bob",
  "data": { "since": "2024-01" },
  "createdAt": 1705312800000
}

---

Get an edge

GET /graphs/{graphId}/edges/{edgeType}/{edgeId}

---

Delete an edge

DELETE /graphs/{graphId}/edges/{edgeType}/{edgeId}

Response 204 — no body.

---

List edges

GET /graphs/{graphId}/edges/{edgeType}?sourceId={id}&targetId={id}

Parameter	Description
sourceId	Filter edges by source node
targetId	Filter edges by target node
limit	Max edges to return (default 50)