We started to publish end points in "unstable" and "experimental" state, with the promise of stabilizing them once they have seen real-world usage. We have not yet followed up on this promise.

We should go through the API end points, and determine which ones we commit to keep stable according to https://www.mediawiki.org/wiki/API_versioning.

Based on popularity, the most important end points to stabilize would probably be:

• https://en.wikipedia.org/api/rest_v1/?doc#!/Page_content/get_page_html_title
• https://en.wikipedia.org/api/rest_v1/?doc#!/Page_content/getFormatRevision
• https://en.wikipedia.org/api/rest_v1/?doc#!/Transforms/post_transform_html_to_wikitext_title_revision

Especially the html2wt end point could use some clarification around If-Match, based on the discussions in https://github.com/wikimedia/restbase/pull/355 and T113163.