Deprecating an API without breaking clients: Deprecation and Sunset headers, successor-version, and OpenAPI

Most "deprecations" are either silent deletions that break an integration at 2 a.m., or permanent warnings that glow for years until everyone ignores them. A real deprecation is a timeline with a sign