---
title: Sudhanva API versioning and deprecation policy
description: Stable major-version guarantees, RFC 9745 deprecation signals, sunset notice, and migration policy for the sudhanva.me public API.
canonical: https://sudhanva.me/developers/versioning/
last-updated: 2026-10-01
---

# Sudhanva API versioning and deprecation policy

`/api/v1` is stable and is not deprecated. Additive changes can come in 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 an
RFC 9745 `Deprecation` Structured Field date. When retirement is scheduled, it
will also add 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.