Sounds like a perfectly reasonable deprecation strategy. To go a bit further... Document and mark the old endpoints for deletion on the next major release. M

Sounds like a perfectly reasonable deprecation strategy. To go a bit further... Document and mark the old endpoints for deletion on the next major release. Mark the old API endpoints as deprecated in minor releases when the new implementation is completed and the old API endpoint is wrapped. Isn't that the whole purpose of SemVer?