# API versioning and deprecation

The kwnva.design catalog is versioned in the URL path as `/api/v1`.

When a version is retired, responses will include HTTP `Deprecation` and `Sunset` headers and this page will name the successor. Agents should treat the current `v1` path as stable and read `API-Version` on every response.

There is no unannounced breaking change policy: a sunset date will appear at least 90 days before a version is removed.