API:Move

From MediaWiki.org
Jump to: navigation, search
Language: English  • Deutsch • 日本語
Tools clipart.png This page is part of the MediaWiki action API documentation.
MediaWiki APIsAPI:Main page

MediaWiki action API

v · d · e


Token[edit]

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:

Obtaining a move token

Moving pages[edit]

Pages can be moved with action=move.

Parameters[edit]

  • from: Title of the page you want to move. Cannot be used together with fromid.
  • fromid: Page ID of the page you want to move. Cannot be used together with from.
  • to: Title you want to rename the page to.
  • token
  • reason: Reason for the move (optional).
  • movetalk: Move the talk page, if it exists.
  • movesubpages: Move subpages, if applicable.
  • noredirect: Don't create a redirect. Requires the suppressredirect right, which by default is granted only to bots and sysops.
  • watch: Add the page and the redirect to your watchlist. Deprecated. Use the watchlist argument. (deprecated in 1.17)
  • unwatch: Remove the page and the redirect from your watchlist. Deprecated. Use the watchlist argument. (deprecated in 1.17)
  • watchlist: Unconditionally add or remove the page from your watchlist, use preferences or do not change watch (see API:Edit). 1.17+
  • ignorewarnings: Ignore any warnings.

Example[edit]

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. Moving Main Pgae (sic) and its talk page to Main Page, without creating a redirect

Possible errors[edit]

All errors are formatted as:

<error code="code" info="info">
Code Info
nofrom The from parameter must be set
noto The to parameter must be set
notoken The token parameter must be set
cantmove-anon Anonymous users can't move pages
cantmove You don't have permission to move pages
cantmovefile You don't have permission to move files.
Note: If file moving is disabled altogether, you'll get an immobilenamespace error instead
selfmove Can't move a page to itself
immobilenamespace You tried to move pages from or to a namespace that is protected from moving
articleexists The destination article already exists and is not a redirect to the source article
protectedpage You don't have permission to perform this move
protectedtitle The destination article has been protected from creation
nonfilenamespace Can't move a file to a non-file namespace
filetypemismatch The new file extension doesn't match its type
mustbeposted The move module requires a POST request

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 talkmove-error-code and talkmove-error-info fields.
  • Subpages: The relevant error will be returned as a standard code/info structure under the subpages key.

action=move

(main | move)
  • This module requires read rights.
  • This module requires write rights.
  • This module only accepts POST requests.
  • Source: MediaWiki
  • License: GPL-2.0+

Move a page.

Parameters:
from

Title of the page to rename. Cannot be used together with fromid.

fromid

Page ID of the page to rename. Cannot be used together with from.

Type: integer
to

Title to rename the page to.

This parameter is required.
reason

Reason for the rename.

Default: (empty)
movetalk

Rename the talk page, if it exists.

Type: boolean (details)
movesubpages

Rename subpages, if applicable.

Type: boolean (details)
noredirect

Don't create a redirect.

Type: boolean (details)
watch
Deprecated.

Add the page and the redirect to the current user's watchlist.

Type: boolean (details)
unwatch
Deprecated.

Remove the page and the redirect from the current user's watchlist.

Type: boolean (details)
watchlist

Unconditionally add or remove the page from the current user's watchlist, use preferences or do not change watch.

One of the following values: watch, unwatch, preferences, nochange
Default: preferences
ignorewarnings

Ignore any warnings.

Type: boolean (details)
token

A "csrf" token retrieved from action=query&meta=tokens

This parameter is required.