Every API feature eventually reaches the end of its useful life. The endpoint was designed before the domain was understood. The schema made assumptions that no longer hold. A better approach exists. The old version must go. How you handle that retirement determines whether your API’s integrators trust you or resent you.

Deprecation done well is a communication and scheduling problem. Deprecation done poorly is a breaking change that happens without warning.