Create a distribution list of all customers to inform them of an upcoming backward-incompatible change at least one month before replacing the old API with the new API.

Create an automated process to generate API documentation, and update the public API documentation as part of the CI/CD process when deploying an update to the API.

Use a versioning strategy for the APIs that increases the version number on every backward-incompatible change.

Use a versioning strategy for the APIs that adds the suffix “DEPRECATED” to the current API version number on every backward-incompatible change. Use the current version number for the new API.