Skip to main content
Updates an edge’s relation or fact by invalidating the old edge and creating a new one. This preserves the full history of changes.

​
Parameters

​
id
string
required
Edge ID to update.
​
relation
string
New relation type. Keeps the old value if omitted.
​
fact
string
New fact description. Keeps the old value if omitted.

​
Behavior

  1. Retrieves the existing edge
  2. Marks it as expired (expiredAt and invalidAt set to now)
  3. Creates a new edge with the same source/target but updated relation/fact
  4. Sets validAt on the new edge to the current timestamp
The old edge remains in the database for historical reference.