---
title: Sudhanva API versioning and deprecation policy
canonical: https://sudhanva.me/developers/versioning/
last-updated: 2026-08-22
---

# Sudhanva API versioning and deprecation policy

`/api/v1` is stable and is not deprecated. Additive changes may be made within
v1. Breaking changes use a new major URL path.

Stable API responses include an RFC 9745 `Link` relation to this policy. That
link does not mean the version is deprecated. A future deprecation will add a
standards-compliant `Deprecation` Structured Field date and, when retirement is
scheduled, an RFC 8594 `Sunset` HTTP-date.

The minimum public migration window is 90 days. Notices and migration guidance
will appear in this policy, the developer docs, `llms.txt`, and OpenAPI.