# `mix surfex.retire`
[🔗](https://github.com/dcoai/surfex/blob/v0.6.2/lib/mix/tasks/surfex.retire.ex#L1)

Retires a relation (`Surfex.Record.retire/6`): an entry saying it no longer applies. It
is appended like any other, and the relation's history stays in the log.

    mix surfex.retire "spec.md#Carts/Discounts" MyApp.Cart.discount/2 --type implements --note "discounts dropped"

An end need not still be scanned: retiring is how an orphaned relation is put to rest.

Retiring a pair that was never related **declines** it: a suggestion turned down before
anyone accepted it. `--note` is required then, saying why, and `mix surfex.suggest`
doesn't propose the pair again.

    mix surfex.retire spec.md#limits Wren.max_len/0 --type implements --note "documented in §2"

---

*Consult [api-reference.md](api-reference.md) for complete listing*