Found at “Deactivating an API, one step at a time” on 2024-11-26 12:28:13 +01:00.

The only suggestion I’d add is to implement API brownouts - short periods of time where the deprecated API returns errors, several months before the final deprecation. This can help give users who don’t read emails from you notice that they need to pay attention before their integration breaks entirely.