Because the API was explicitly showed as "experimental", you can remove it instead of putting it as deprecated. And add the documentation at the start about ".. versionchanged:: 1.8.0" and list the method you've removed.