# WebAnalyzer API — versioning & deprecation policy

Last updated: 2026-09-03. Canonical: https://webanalyzer.dev/deprecation-policy.md
(also summarized at https://webanalyzer.dev/developers#deprecation).

## Versioning

The API is **path-versioned**: the current stable version lives under `/api/v1`.
Within a version, changes are only ever additive — fields are added, never renamed,
removed or re-typed. Anything backwards-incompatible ships under a new prefix
(`/api/v2`), never in place.

## Deprecation

When an operation or a whole version is deprecated:

1. A notice is published at https://webanalyzer.dev/developers#deprecation with the
   replacement and the retirement date.
2. The deprecated operation's responses carry a `Deprecation` header (RFC 9745) from
   the day of the notice, and a `Sunset` header (RFC 8594) with the retirement date.
3. The deprecated surface keeps working for **at least 6 months** after the notice.

**Nothing is deprecated today** — no endpoint currently sends `Deprecation` or
`Sunset` headers.

## Contact

Questions about an integration: hello@webanalyzer.dev