# supersedes (/catalog/edges/supersedes)

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



## supersedes [#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](/build/edges#edge-types) says when to use it and when another edge type fits.

## The rules it holds [#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 [#in-the-bin]

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

## In a folder [#in-a-folder]

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

## Example [#example]

A revised lease that replaces its draft:

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