API Deprecation

The process of marking an API version or endpoint as obsolete, giving consumers a sunset date to migrate before the endpoint is removed. Deprecation is communicated via the Sunset and Deprecation HTTP response headers, changelog notices, and documentation updates. A grace period of weeks or months allows clients to migrate without a hard breaking change. Skipping proper deprecation leads to breaking changes that damage developer trust.