# Deprecation and Sunset policy

The kwnva.design public API is versioned in the URL as `/api/v1`.

## Current version

`v1` is current. Responses include:

- `API-Version: v1`
- `Deprecation: false`
- `Sunset: Wed, 01 Jan 2031 00:00:00 GMT` (placeholder until a real retirement is announced)

## When a version is retired

A sunset date will appear at least 90 days before a version is removed. During that window:

- Responses include HTTP `Deprecation: true`
- Responses include HTTP `Sunset` with the removal date
- This page and `/api/versioning.md` name the successor path

There is no unannounced breaking change policy.