[Jan 2026] Remove trailing slash routes for Transform endpoints
Open, MediumPublic2 Estimated Story Points
Actions

Assigned To

Authored By

	HCoplin-WMF
	Sep 17 2025, 1:04 PM

Description

Scheduled for end of Jan 2026

Description

We currently have duplicates of every transform endpoint -- one with a trailing slash, and one without. These are treated as separate routes both within the documentation and for routing purposes. Due to limited adoption of the trailing slash version of the endpoints, we intend to remove them and consolidate onto the non-trailing slash versions as the single source of truth for transforms.

NOTE: Blocked by: T404854: Mark and announce transform endpoints with trailing slash as deprecated. The announcement of deprecation should come at least a few weeks before fully removing the trailing slash endpoints.

Conditions of acceptance

Remove trailing slash endpoints from code
Trailing slash endpoints no longer appear in the REST Sandbox
Announce that the deprecation is complete through the standard channels

Details

Related Changes in Gerrit:

	Subject	Repo	Branch	Lines +/-
	REST: Remove deprecated "trailing slash" transform endpoints	mediawiki/core	master	+94 -185

Customize query in gerrit

Related Objects
Search...

		Status	Subtype	Assigned	Task
		Resolved	BUG REPORT	BPirkle	T391712 Transform "Try it out" doesn't work in REST Sandbox
		Open		BPirkle	T404855 [Jan 2026] Remove trailing slash routes for Transform endpoints

Event Timeline

HCoplin-WMF created this task.Sep 17 2025, 1:04 PM

HCoplin-WMF removed a subscriber: Chlod.

HCoplin-WMF moved this task from MWI-Sprint-18 (2025-09-09 to 2025-09-23) to Next Up on the MW-Interfaces-Team board.Sep 17 2025, 1:16 PM

HCoplin-WMF edited projects, added MW-Interfaces-Team; removed MW-Interfaces-Team (MWI-Sprint-18 (2025-09-09 to 2025-09-23)).

BPirkle mentioned this in T405038: [SPIKE] Propose an in-code mechanism for marking endpoints as deprecated.Oct 2 2025, 9:03 PM

OWresch-WMF triaged this task as Medium priority.Oct 23 2025, 3:28 PM

OWresch-WMF set the point value for this task to 2.

If the endpoint handler removed trailing slashes, there would be no need to obsolete the endpoints (though they could still be deprecated for clarity), and old clients would still work. There would be no need for individual documentation or routing, just as in the current proposal.

HCoplin-WMF renamed this task from Remove trailing slash routes for Transform endpoints to [Jan 2026] Remove trailing slash routes for Transform endpoints.Oct 28 2025, 1:57 PM

HCoplin-WMF updated the task description. (Show Details)

HCoplin-WMF moved this task from Next Up to MWI-Sprint-25 (2026-01-13 to 2026-01-27) on the MW-Interfaces-Team board.Tue, Jan 13, 3:46 PM

HCoplin-WMF edited projects, added MW-Interfaces-Team (MWI-Sprint-25 (2026-01-13 to 2026-01-27)); removed MW-Interfaces-Team.

Change #1226364 had a related patch set uploaded (by BPirkle; author: BPirkle):

[mediawiki/core@master] REST: Remove deprecated "trailing slash" transform endpoints

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

gerritbot added a project: Patch-For-Review.Tue, Jan 13, 10:00 PM

BPirkle updated the task description. (Show Details)Wed, Jan 14, 2:38 PM

BPirkle moved this task from Committed to In Progress on the MW-Interfaces-Team (MWI-Sprint-25 (2026-01-13 to 2026-01-27)) board.Wed, Jan 14, 2:50 PM

BPirkle moved this task from In Progress to Code Review on the MW-Interfaces-Team (MWI-Sprint-25 (2026-01-13 to 2026-01-27)) board.

I checked Turnillo here and here, and the endpoints still looks fine to remove.