# Deprecation policy

How much notice you get before anything in the HQ API goes away.



* **Dated versions.** A breaking change ships under a new `HQ-Version`. Keys pinned to an older
  version keep the old behaviour. See [Versioning](/docs/api/versioning/).
* **Notice.** Before an old dated version stops working we give at least **6 months** of notice.
  Responses served at that version carry `Deprecation` and `Sunset` headers, and we email the owners
  of keys still pinned to it 90, 30 and 7 days before.
* **The major version.** `/v1` stays supported for at least **24 months** after a `/v2` exists.
* **Every change** is in the [changelog](/docs/api/changelog/).
