Maniphest T428149

Fix type, media type, and array issues in the MediaWiki REST API OAD
Closed, ResolvedPublic3 Estimated Story Points
Actions

Assigned To

Authored By

	KBach
	Jun 4 2026, 11:44 AM

Project Tags

Referenced Files

None

Subscribers

Description

Fix linter issues related to types, media types, and arrays (30 matches) in the MediaWiki REST API OAD:

Add types to schema properties (wikimedia-response-schema-properties-type)
Ensure schemas with type: array specify items; after T409113 is done (built-in rule: array-items)
Ensure all responses have valid media types (wikimedia-response-valid-media-type)
Ensure all media types are valid (wikimedia-valid-media-type)

Note that only global properties and properties under paths starting with /v1/ are in scope for this task.

Details

Related Changes in Gerrit:

	Subject	Author	Repo	Branch	Lines +/-
	REST: add explicit type to schema properties	Milazg	mediawiki/core	master	+3 -0
	REST: Update schema definitions for array types and operation tags	Milazg	mediawiki/core	master	+137 -7

Customize query in gerrit

Related Changes in GitLab:

	Title	Reference	Author	Source Branch	Dest Branch
	Rules: allow valid media types and handle polymorphic properties	repos/ci-tools/wikimedia-spectral-ruleset!14	milazg	mgoncalves/T428149	main

Customize query in GitLab

Related Objects
Search...

		Status	Subtype	Assigned	Task
		Open		KBach	T422476 [Hypothesis] 5.2.5b: Productionalize API spec linting
		Open		None	T422480 [5.2.5b Epic] Improve MediaWiki REST API OpenAPI description
		Open		None	T427793 Fix linter errors and warnings in the MW REST API OAD
		Resolved		MGoncalves-WMF	T428149 Fix type, media type, and array issues in the MediaWiki REST API OAD

Event Timeline

KBach created this task.Jun 4 2026, 11:44 AM

KBach triaged this task as Medium priority.

KBach renamed this task from Fix type, media type, and array issues in the MW REST API OAD to Fix type, media type, and array issues in the MediaWiki REST API OAD.Jun 4 2026, 12:01 PM

KBach mentioned this in T427793: Fix linter errors and warnings in the MW REST API OAD.

KBach updated the task description. (Show Details)Jun 4 2026, 12:04 PM

KBach updated the task description. (Show Details)Jun 4 2026, 12:13 PM

As part of my Clinic Duty rotation, I add a project tag and move this task to "To Estimate" because the task is clear enough to be sized and valuable in our current hypothesis.

KBach updated the task description. (Show Details)Jun 8 2026, 12:46 PM

KBach updated the task description. (Show Details)Jun 8 2026, 1:48 PM

Notes for estimation:

Work involves adding missing type fields to response schema properties and fixing invalid media type strings in the REST handler classes
Changes are spread across multiple handler PHP files but are purely additive — no logic changes, low risk
The array-items portion is still blocked on T409113 and should be excluded from the estimate
Verification is done by running the linter against the generated document

AGhirelli-WMF set the point value for this task to 3.Jun 11 2026, 3:37 PM

AGhirelli-WMF moved this task from To Estimate to Ready, Sized, & Prioritized on the MediaWiki-API-Platform-Team board.Jun 11 2026, 4:18 PM

KBach edited projects, added: MediaWiki-API-Platform-Team (MWI-Sprint-36 (2026-06-16 to 2026-06-30)); removed: MediaWiki-API-Platform-Team.Jun 16 2026, 11:23 AM

MGoncalves-WMF claimed this task.Mon, Jun 22, 2:57 PM

MGoncalves-WMF changed the task status from Open to In Progress.Tue, Jun 23, 5:30 PM

MGoncalves-WMF moved this task from Committed to In Progress on the MediaWiki-API-Platform-Team (MWI-Sprint-36 (2026-06-16 to 2026-06-30)) board.Wed, Jun 24, 2:16 AM

Change #1304825 had a related patch set uploaded (by Aghirelli; author: Milazg):

[mediawiki/core@master] REST: Update schema definitions for array types and operation tags

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

gerritbot added a project: Patch-For-Review.Thu, Jun 25, 12:40 PM

AGhirelli-WMF moved this task from In Progress to Code Review on the MediaWiki-API-Platform-Team (MWI-Sprint-36 (2026-06-16 to 2026-06-30)) board.Thu, Jun 25, 12:41 PM

AGhirelli-WMF moved this task from Code Review to Demo Ready! on the MediaWiki-API-Platform-Team (MWI-Sprint-36 (2026-06-16 to 2026-06-30)) board.

Change #1304825 merged by jenkins-bot:

[mediawiki/core@master] REST: Update schema definitions for array types and operation tags

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

ReleaseTaggerBot added a project: MW-1.47-notes (1.47.0-wmf.9; 2026-06-30).Thu, Jun 25, 1:00 PM

Maintenance_bot removed a project: Patch-For-Review.Thu, Jun 25, 1:31 PM

MGoncalves-WMF moved this task from Demo Ready! to In Progress on the MediaWiki-API-Platform-Team (MWI-Sprint-36 (2026-06-16 to 2026-06-30)) board.Mon, Jun 29, 1:51 PM

Change #1306686 had a related patch set uploaded (by Milazg; author: Milazg):

[mediawiki/core@master] REST: add explicit type to schema properties

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

gerritbot added a project: Patch-For-Review.Tue, Jun 30, 1:21 PM

HCoplin-WMF edited projects, added: MediaWiki-API-Platform-Team (MediaWiki-Interfaces-Sprints); removed: MediaWiki-API-Platform-Team (MWI-Sprint-36 (2026-06-16 to 2026-06-30)).Tue, Jun 30, 3:20 PM

HCoplin-WMF moved this task from Committed to In Progress on the MediaWiki-API-Platform-Team (MediaWiki-Interfaces-Sprints) board.

milazg opened https://gitlab.wikimedia.org/repos/ci-tools/wikimedia-spectral-ruleset/-/merge_requests/14

Rules: allow valid media types and handle polymorphic properties

MGoncalves-WMF moved this task from In Progress to Code Review on the MediaWiki-API-Platform-Team (MediaWiki-Interfaces-Sprints) board.Thu, Jul 2, 9:44 PM

Change #1306686 merged by jenkins-bot:

[mediawiki/core@master] REST: add explicit type to schema properties

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

ReleaseTaggerBot edited projects, added: MW-1.47-notes (1.47.0-wmf.10; 2026-07-07); removed: MW-1.47-notes (1.47.0-wmf.9; 2026-06-30).Mon, Jul 6, 4:00 PM

aghirelli merged https://gitlab.wikimedia.org/repos/ci-tools/wikimedia-spectral-ruleset/-/merge_requests/14

Rules: allow valid media types and handle polymorphic properties

AGhirelli-WMF closed this task as Resolved.Mon, Jul 6, 4:41 PM

AGhirelli-WMF moved this task from Code Review to Demo Ready! on the MediaWiki-API-Platform-Team (MediaWiki-Interfaces-Sprints) board.

Maintenance_bot removed a project: Patch-For-Review.Mon, Jul 6, 5:31 PM

OWresch-WMF edited projects, added: MediaWiki-API-Platform-Team; removed: MediaWiki-API-Platform-Team (MediaWiki-Interfaces-Sprints).Tue, Jul 14, 3:50 PM

OWresch-WMF moved this task from MediaWiki-Interfaces-Sprints to Done on the MediaWiki-API-Platform-Team board.