> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nozlerouting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API versioning policy and deprecation windows

> How Nozle versions the Routing API: stable /v1/ prefix, additive changes within a major version, and deprecation windows for breaking changes in /v2/.

The `/v1/` URL prefix is stable. Within v1, additive changes
(new endpoints, new optional request fields, new response
fields) ship without notice. Breaking changes (renamed or
removed fields, changed types, changed semantics) ship as a new
prefix (`/v2/`) with v1 supported in parallel for a documented
deprecation window. Error codes are stable strings — we add to
the list but never rename existing ones.