This page is part of the MediaWiki Action API documentation.

POST request to revert a file to an old version.

Token

To revert a file to an older version, a CSRF token is required. The CSRF token is the same for all pages, but changes at every login. CSRF tokens can be obtained via action=query&meta=tokens with type=csrf (MW 1.24+). For older versions, you can use API:Tokens (action) or API:Info to get an edit token.

Parameters

• filename: Target filename, without the File: prefix.
• archivename: Archive name of the revision to revert to. This should include the timestamp of the revision and the name of the file in the format: yyyyMMddhhmmss!filename. This information can be found using Imageinfo with iilimit set higher than 1. When looking at a file's page, the seconds will not be displayed; the needed archive name can be found by hovering over the older image and looking at the displayed file name. (Note that the ! will already have been urlencoded as %21.)
• token: A CSRF token obtained as per the Tokens section, above. Take care to urlencode the trailing +\ as %2B%5C
• comment: Upload comment.

Error Codes

In addition to the usual stuff:

Example

Revert Wiki.png to the version from 15:27:40, 5 March 2011.

{
  "filerevert": {
    "result": "Success"
  }
}

The following documentation is the output of Special:ApiHelp/filerevert, automatically generated by the pre-release version of MediaWiki that is running on this site (MediaWiki.org).