LPS-45615 document breaking changes in the API