API:Move

Token
To move a page, a move token is required. This token is equal to the edit token and the same for all pages, but changes at every login. Moves tokens can be obtained via action=tokens with type=move (MW 1.20+), or by using the following method:

Moving pages
Pages can be moved with action=move.

Parameters

 * : Title of the page you want to move. Cannot be used together with
 * : Page ID of the page you want to move. Cannot be used together with
 * : Title you want to rename the page to
 * : A move token previously retrieved through prop=info. Take care to urlencode the '+' as '%2B'.
 * : Reason for the move (optional)
 * : Move the talk page, if it exists
 * : Move subpages, if applicable
 * : Don't create a redirect. Requires the suppressredirect right, which by default is granted only to bots and sysops
 * : Add the page and the redirect to your watchlist
 * : Remove the page and the redirect from your watchlist
 * : Unconditionally add or remove the page from your watchlist, use preferences or do not change watch (see API:Edit)
 * : Ignore any warnings

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

Possible errors
All errors are formatted as:

NOTE: The Move API uses two additional error handling methods when the page move succeeded, but the talk page or sub-page move failed:
 * Talk page: The relevant error will be returned in the  and   fields.
 * Subpages: The relevant error will be returned as a standard /  structure under the   key.