---
title: "Shivanshu Tiwari API Deprecation and Versioning Policy"
description: "Official API versioning and deprecation policy for shivanshutiwari.in."
canonical: "https://shivanshutiwari.in/developers/deprecation"
lastUpdated: "2026-09-04"
---

# Shivanshu Tiwari API Deprecation and Versioning Policy

This document declares the stability, versioning, and deprecation guarantees provided by the **Shivanshu Tiwari Portfolio API**.

## 1. Versioning Strategy

The API follows explicit URI-path versioning under `/api/v<N>` (currently `/api/v1`). Non-breaking changes are additive; breaking changes result in a new major version path.

## 2. Deprecation and Sunset Headers (RFC 8594)

When an API version or endpoint is scheduled for retirement, responses include standard IETF HTTP headers:

```http
Deprecation: @1798761600
Sunset: Thu, 31 Dec 2026 23:59:59 GMT
Link: <https://shivanshutiwari.in/developers/deprecation>; rel="deprecation"
```

## 3. Minimum Notice Period

We guarantee a minimum of **180 days (6 months)** notice between the first broadcast of a `Sunset` header and endpoint decommission.