---
title: API Versioning and Deprecation
canonical: https://alexgreenshpun.com/deprecation.md
last-updated: 2026-08-31
---

# API Versioning and Deprecation

The current public API is version 1. No operation is deprecated.

Breaking changes use a new versioned URL instead of silently changing `/api/v1`. When a public operation is scheduled for retirement, the documentation and OpenAPI description will identify the replacement and target date. Affected responses will use the `Deprecation` and `Sunset` headers where applicable.

Alex intends to provide at least 90 days' notice when practical. An urgent security, privacy, or legal issue may require a faster change.