supersedes

Says an item replaces another as the current version, such as a revised contract and its draft.

supersedes

Says that an item replaces another item as the current version, such as a revised document that replaces its earlier draft.

acyclic: true

An item lists what it Supersedes, and the earlier item what it's Superseded by. Edges says when to use it and when another edge type fits.

The rules it holds

  • One each way. An item supersedes at most one item and is superseded by at most one, so versions form a single line. A second edge at either end is refused with 400 edge_constraint_violation.
  • No loops. An edge that would lead back to where the line started is refused with 400 edge_cycle.

In the bin

Either end can go to the bin, or be purged, and the other stays where it is.

In a folder

The newer item's file writes the edge as a supersedes line.

Example

A revised lease that replaces its draft:

{
  "edge_type": "supersedes",
  "from_id": "01a1f139-e080-70c7-83d3-2a3f48a1eb00",
  "to_id": "01a1f139-e088-76db-afa2-16f1291328f6"
}

On this page