MediaWiki API help

This is an auto-generated MediaWiki API documentation page.

Documentation and examples: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=tag

(main | tag)

This module requires read rights.
This module requires write rights.
This module only accepts POST requests.
Source: MediaWiki
License: GPL-2.0-or-later

Add or remove change tags from individual revisions or log entries.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Tag

Specific parameters:

Other general parameters are available.

rcid: One or more recent changes IDs from which to add or remove the tag.; Type: list of integers; Separate values with | or alternative.; Maximum number of values is 50 (500 for clients that are allowed higher limits).
revid: One or more revision IDs from which to add or remove the tag.; Type: list of integers; Separate values with | or alternative.; Maximum number of values is 50 (500 for clients that are allowed higher limits).
logid: One or more log entry IDs from which to add or remove the tag.; Type: list of integers; Separate values with | or alternative.; Maximum number of values is 50 (500 for clients that are allowed higher limits).
add: Tags to add. Only manually defined tags can be added.; Values (separate with | or alternative): AFCH, AWB, Addition of protection template to non-protected page, AntiVandal script, CVPI, Deputy, HotCat, JWB, Newcomer task, New user adding protection template, ProveIt edit, RedWarn, Ultraviolet, WPCleaner, WikiLoop Battlefield, WikiShield script, bot trial, changing time or duration, convenient-discussions, editProtectedHelper, excessive whitespace, fixed lint errors, huggle, invalid-timedtext-edit, large non-free file, massmove, moveToDraft, new user moving page out of userspace, ooze, pageswap, possible birth or death date change, possible formatting issues, pronoun-change, rapid date format changes, self-published-blog, self-published source, shortdesc helper, talk banner shell conversion, twinkle
remove: Tags to remove. Only tags that are either manually defined or completely undefined can be removed.; Separate values with | or alternative.; Maximum number of values is 50 (500 for clients that are allowed higher limits).
reason: Reason for the change.; Default: (empty)
tags: Tags to apply to the log entry that will be created as a result of this action.; Values (separate with | or alternative): AFCH, AWB, Addition of protection template to non-protected page, AntiVandal script, CVPI, Deputy, HotCat, JWB, Newcomer task, New user adding protection template, ProveIt edit, RedWarn, Ultraviolet, WPCleaner, WikiLoop Battlefield, WikiShield script, bot trial, changing time or duration, convenient-discussions, editProtectedHelper, excessive whitespace, fixed lint errors, huggle, invalid-timedtext-edit, large non-free file, massmove, moveToDraft, new user moving page out of userspace, ooze, pageswap, possible birth or death date change, possible formatting issues, pronoun-change, rapid date format changes, self-published-blog, self-published source, shortdesc helper, talk banner shell conversion, twinkle
token: A "csrf" token retrieved from action=query&meta=tokens; This parameter is required.

Examples:

Add the vandalism tag to revision ID 123 without specifying a reason: api.php?action=tag&revid=123&add=vandalism&token=123ABC [open in sandbox]
Remove the spam tag from log entry ID 123 with the reason Wrongly applied: api.php?action=tag&logid=123&remove=spam&reason=Wrongly+applied&token=123ABC [open in sandbox]