Because these endpoints see very little adoption outside of WMF owned features, we expect there to be a relatively short deprecation cycle;

Note they are used in default installation of Math in 1.42 and before (though all such versions are EOL), and later version if they enable the mathoid mode (it is disabled by default). See T373705 and https://www.mediawiki.org/wiki/Extension:Math#Math_output_modes

So before that we need to remove the Mathoid mode from Math.

In T431372#12092928, @Bugreporter wrote:

Because these endpoints see very little adoption outside of WMF owned features, we expect there to be a relatively short deprecation cycle;

Note they are used in default installation of Math in 1.42 and before (though all such versions are EOL), and later version if they enable the mathoid mode (it is disabled by default). See T373705 and https://www.mediawiki.org/wiki/Extension:Math#Math_output_modes

So before that we need to remove the Mathoid mode from Math.

Yep, that's T432511: Remove Mathoid/RESTBase integration from Math extension. I expect we'll do that after the last WMF wiki switches over (schedule at T271001), but before shutting down Mathoid and archiving its repos (T432514).

Change #1326410 had a related patch set uploaded (by Aaron Schulz; author: Aaron Schulz):

[operations/mediawiki-config@master] Mark all Mathoid-based endpoints as deprecated

https://gerrit.wikimedia.org/r/1326410

Change #1326410 merged by jenkins-bot:

[operations/mediawiki-config@master] Mark all Mathoid-based endpoints as deprecated

https://gerrit.wikimedia.org/r/1326410

Mentioned in SAL (#wikimedia-operations) [2026-08-24T20:35:55Z] <aaron@deploy1003> Started scap sync-world: Backport for [[gerrit:1326410|Mark all Mathoid-based endpoints as deprecated (T431372)]]

Mentioned in SAL (#wikimedia-operations) [2026-08-24T20:37:57Z] <aaron@deploy1003> aaron: Backport for [[gerrit:1326410|Mark all Mathoid-based endpoints as deprecated (T431372)]] synced to the testservers (see https://wikitech.wikimedia.org/wiki/Mwdebug). Changes can now be verified there.

Mentioned in SAL (#wikimedia-operations) [2026-08-24T20:48:28Z] <aaron@deploy1003> Finished scap sync-world: Backport for [[gerrit:1326410|Mark all Mathoid-based endpoints as deprecated (T431372)]] (duration: 12m 33s)

Change #1338570 had a related patch set uploaded (by Aaron Schulz; author: Aaron Schulz):

[mediawiki/services/restbase@master] Add "Deprecation" header to math endpoint responses

https://gerrit.wikimedia.org/r/1338570

Change #1338570 abandoned by Aaron Schulz:

[mediawiki/services/restbase@master] mathoid: add "Deprecation" header to math endpoint responses

Reason:

this the mirror

https://gerrit.wikimedia.org/r/1338570

Change #1338570 restored by Aaron Schulz:

[mediawiki/services/restbase@master] mathoid: add "Deprecation" header to math endpoint responses

https://gerrit.wikimedia.org/r/1338570

Change #1339947 had a related patch set uploaded (by Aaron Schulz; author: Aaron Schulz):

[operations/puppet@production] restbase: make /media/math/ endpoints emit 'Deprecated' header

https://gerrit.wikimedia.org/r/1339947

Change #1338570 abandoned by Aaron Schulz:

[mediawiki/services/restbase@master] mathoid: add "Deprecation" header to math endpoint responses

Reason:

Better to do it the ATS way

https://gerrit.wikimedia.org/r/1338570

@Fabfur: This perhaps needs to be done on the haproxy layer. Can you please check that and confirm here?

@HCoplin-WMF we discussed this with @Clement_Goubert last week, the proper way to implement this should be on haproxy side, which is why the change was abandoned.

I know that @Fabfur accepted to take a look at doing that (thanks!).

Hello, yes we can deprecate it at HAProxy level, just let me know what exactly to use to match (all paths, specific hosts, and so on) and if we want to respond with some specific status code (usually 403 but we can also redirect or add some additional header)

In T431372#12406155, @Fabfur wrote:

Hello, yes we can deprecate it at HAProxy level, just let me know what exactly to use to match (all paths, specific hosts, and so on) and if we want to respond with some specific status code (usually 403 but we can also redirect or add some additional header)

This would be adding the following headers:

# Deprecated since 2026-08-31T00:00:00Z RFC9745
Deprecation: @1788134400 
# Sunset on 2026-09-28T00:00:00Z RFC 8594
Sunset: Mon, 28 September 2026 00:00:00 UTC

to every path matching https://(.*)/api/rest_v1/media/math

Change #1353052 had a related patch set uploaded (by Fabfur; author: Fabfur):

[operations/puppet@production] cace:haproxy: deprecating mathoid as a service endpoint

https://gerrit.wikimedia.org/r/1353052

@HCoplin-WMF We're only returning the header for now, and not a 403 response, right?

Confirmed out of band that we are for now only returning the headers and not blocking traffic. We can do that in the same place when ready.
Once the haproxy patch is merged, headers will be returned for every path under /api/rest_v1/media/math/

Change #1353052 merged by Fabfur:

[operations/puppet@production] cache:haproxy: deprecating mathoid as a service endpoint

https://gerrit.wikimedia.org/r/1353052

Confirmed that the cache servers are now returning the deprecation and sunset headers for that path