Deprecating an API without breaking clients: Deprecation and Sunset headers, successor-version, and OpenAPI
Deleting an endpoint is not a deprecation policy, and announcing it once in a changelog does not reach the integrations that actually call it. RFC 8594 gives you the Deprecation and Sunset response headers, Link rel=successor-version points at the replacement, and OpenAPI marks operations...