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=unblock
(main | unblock)
- This module requires read rights.
- This module requires write rights.
- This module only accepts POST requests.
- Source: MediaWiki
- License: GPL-2.0-or-later
Unblock a user.
Specific parameters:
Other general parameters are available.
- id
ID of the block to unblock (obtained through list=blocks). Cannot be used together with user.
- Type: integer
- user
User to unblock. Cannot be used together with id.
- Type: user, by any of username, IP, Temporary user, IP range and user ID (e.g. "#12345")
- userid
- Deprecated.
Specify user=#ID instead.
- Type: integer
- reason
Reason for unblock.
- Default: (empty)
Change tags to apply to the entry in the block log.
- Values (separate with | or alternative): Automatic update from connected wiki, Connecting-Senses, Czech-Authorities-Sync, InfoboxExport gadget, WE-Framework gadget, WikibaseJS-cli, WikibaseJS-edit, client-automatic-update, client-linkitem-change, contenttranslation, contenttranslation-v2, data-bridge, dataDrainer, distributed-game, gadget-addsenseimage, gadget-draggablesitelinks, gadget-dragndrop, gadget-merge, gadget-move, gadget-moveclaim, gadget-rearrangevalues, openrefine, openrefine-3.4, openrefine-3.5, openrefine-3.6, openrefine-3.7, openrefine-3.8, openrefine-4.0, osm-id-sync, reference-game, sectiontranslation, svwiki-DescriptionGadget, termbox, view-it, wikibase-patcher-v1, wikidata-for-firefox, wikidata-for-web, wikidata-ui, wikimedia-commons-app, wwwyzzerdd
- watchuser
Watch the user's or IP address's user and talk pages.
- Type: boolean (details)
- watchlistexpiry
Watchlist expiry timestamp. Omit this parameter entirely to leave the current expiry unchanged.
- Type: expiry (details)
- token
A "csrf" token retrieved from action=query&meta=tokens
- This parameter is required.
Examples:
- Unblock block ID #105.
- api.php?action=unblock&id=105 [open in sandbox]
- Unblock user Bob with reason Sorry Bob.
- api.php?action=unblock&user=Bob&reason=Sorry%20Bob [open in sandbox]