API:Rollback

Rollback
Rolling back a page means undoing the last series of edits by one user.

In other words, rollback keeps undoing revision after revision until it encounters one made by someone different.

This functionality is identical to the one provided by the [ ] links in the graphical interface.

The rollback revision will be marked as minor.

Optionally, both the rollback and the edits being rolled back can be marked as bot, which hides them from Special:RecentChanges by default.

Token
To rollback a page, a rollback token is required.

If your wiki is using MediaWiki 1.24+, you can use action=query&meta=tokens&type=rollback to get a rollback token.

For MediaWiki 1.23 or earlier, follow these instructions:

Unlike most other tokens, rollback tokens aren't universal: they're not only different for every login, but also depend on the title of the page and the name of the user whose edits are to be rolled back.

A rollback token can be obtained as follows:

Permissions
Rollback requires both the   and the   right on the target page; currently, this means that OAuth consumers, bot passwords etc. require both the   and the   grant –   alone is not enough!

Rolling back pages
Pages can be rolled back with action=rollback.

Parameters
Note that only one of   or   are required, and they cannot be used together.



Example
Note: In this example, all parameters are passed in a GET request just for the sake of simplicity. However, action=rollback requires POST requests; GET requests will cause an error.

Returned fields


If rolling back wouldn't change the page, no new revision is made. In this case,  will be equal to.

Possible errors
In addition to 1>Special:MyLanguage/API:Errors#Standard error messages</>|the usual stuff: