Howdy API artists, bot builders, and tool tinkerers!
We are continuing to reroute all web API traffic through a common API
Gateway. This week, Action API traffic began flowing through the common
gateway. Requests from Group 0 wikis are now being routed through
the common gateway, and we expect to follow the following deployment
schedule for the remaining Wikimedia projects:
- 100% Group 0 today (Oct 30)
- 50% Group 1 on Monday, Nov 3
- 100% Group 1 on Wednesday, Nov 5
- All remaining wikis ramp up week of Nov 10
This is purely introducing another layer of infrastructure, and we expect
the change to be non-breaking and non-disruptive. We are also keeping a
close eye out for any anomalies as we dial up proportional traffic. If any
issues are observed in your own bots, features, or tools, please file a
phabricator ticket to the Service Ops team board
<https://phabricator.wikimedia.org/tag/serviceops/>.
Why is this change happening?
As mentioned in the API as a Product Tech Blog
<https://techblog.wikimedia.org/2025/06/12/apis-as-a-product-investing-in-th…>
published
earlier this year and as part of the WE5 objective
<https://meta.wikimedia.org/wiki/Talk:Wikimedia_Foundation_Annual_Plan/2025-…>
(KR5.2),
we are working to consolidate and centralize our API infrastructure.
Centralizing API routing will make observability across APIs easier,
allowing us to make better data-driven decisions. Having a single,
centralized API gateway also simplifies API management, enabling us to
continue streamlining and standardizing our API offerings.
What’s next?
We will continue rerouting non-MediaWiki endpoints through the common
gateway in the coming months. Keep an eye out for more announcements here
and on Tech News <https://meta.wikimedia.org/wiki/Tech/News>!
Feel free to respond here, find us on phabricator, or add to a on-wiki
discussion thread if you have any questions, comments, or concerns!
Thanks,
Halley
*Halley Coplin* (she/her)
Sr. Product Manager, MediaWiki Interfaces
Wikimedia Foundation <https://wikimediafoundation.org/>
Hello Wikimedia REST API users!
As part of the RESTBase Sunsetting project
<https://phabricator.wikimedia.org/T262315>, we are rerouting the lint
endpoints in the Wikimedia REST API
<https://www.mediawiki.org/wiki/Wikimedia_REST_API> through MediaWiki. Both
page and transform lint endpoints are affected. This change is expected to
be seamless and non-breaking. However, because this work involves a service
change, we would like your help to ensure that no tools, bots, or other
integrations relying on these endpoints are negatively impacted.
*==== Impacted endpoints ====*
Lint endpoints offered by the Wikimedia REST API
<https://en.wikipedia.org/api/rest_v1/> (under the /api/rest_v1/ path) are
being rerouted. No other endpoints are affected. The specific endpoints are
limited to:
GET /page/lint/{title}/
GET /page/lint/{title}/{revision}
POST /transform/wikitext/to/lint
POST /transform/wikitext/to/lint/{title}
POST /transform/wikitext/to/lint/{title}/{revision}
*==== Timeline & next steps ==== *
The rerouted endpoints are currently live on test.wikipedia.org -- please
feel free to test and verify functionality there at your earliest
convenience.
Assuming no issues are observed or reported, we plan to utilize the
following deployment schedule:
- *Tuesday, Oct 28*: Rerouting is live on test and test2 wikis.
- *Monday, Nov 3*: Enable rerouting on Group 0 wikis.
- *Tuesday, Nov 4*: Enable rerouting on Group 1 wikis.
- *Thursday, Nov 6*: Enable rerouting on all remaining wikis.
*==== How to report issues ====*
Please see T384216 <https://phabricator.wikimedia.org/T384216> for more
information, or to report any observed issues or changes in behavior
related to this rerouting. You may also reply directly to this email, or
file a new ticket to the MediaWiki Interfaces team board
<https://phabricator.wikimedia.org/project/view/6931/>.
Thanks,
Halley
*Halley Coplin* (she/her)
Sr. Product Manager, MediaWiki Interfaces
Wikimedia Foundation <https://wikimediafoundation.org/>
Greetings, REST API consumers!
We recently marked duplicate transform endpoints as deprecated in the
MediaWiki REST API. The deprecated endpoints reflect a trailing slash at
the end of the path, and are duplicative of comparable endpoints without
the trailing slash. Developers who are calling these endpoints are advised
to remove the trailing slash from the path their requests. *We plan to
remove the trailing slash endpoints by the end of January 2026*.
*== What should I call instead? ==*
Identical endpoints already exist; simply remove the trailing slash from
your requests and the calls will go through. Users can review documentation
and execute test calls for both versions of the transform endpoints using
the new REST Sandbox <https://www.mediawiki.org/wiki/Special:RestSandbox>
(Special:RestSandbox), as seen below:
[image: image.png]
*== Why are we deprecating and removing these endpoints? ==*
These endpoints contain a trailing slash in the path, which is confusing
for consumers and goes against REST routing paradigms. The trailing slash
was added erroneously within the MediaWiki Core APIs and resulted in
duplicate routes when combined with endpoint migration for the RESTBase
Sunsetting project. Few users have adopted the trailing slash version,
which is motivating us to move quickly on its removal, before more tools,
bots, and developers are impacted.
*== Will this result in a major version change for the MediaWiki REST API?
==*
No. Although this is technically a breaking change, we plan to remove the
endpoints without incrementing the major version across the board. In this
case, we decided to proceed with removal without a version increment due to
the limited adoption of these specific endpoints, and to minimize
disruption across our developer community as a major version change may
have more cascading impacts.
*== Where can I get more information about the deprecation process? ==*
For more information about our approach to deprecation overall, see the new API
Deprecation <https://www.mediawiki.org/wiki/API/Deprecation> page for more
information about deprecation processes.
If you have any questions, comments, or concerns, please feel free to raise
them here, or join the discussion on the new API Deprecation talk page
<https://www.mediawiki.org/w/index.php?title=Talk:API/Deprecation>.
Thanks,
Halley
*Halley Coplin* (she/her)
Sr. Product Manager, MediaWiki Interfaces
Wikimedia Foundation <https://wikimediafoundation.org/>