API:Delete

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
MediaWiki version: 1.12

Token[edit | edit source]

To delete a page, 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+).

Deleting pages[edit | edit source]

Pages can be deleted with action=delete.

Parameters[edit | edit source]

  • title: The page you want to delete.
  • pageid: The page id of the page you want to delete
  • token: The CSRF token obtained in the previous request. Take care to urlencode the trailing +\ as %2B%5C.
  • reason: The reason for the deletion (optional). If not provided, an automatically generated reason will be used.
  • watch: Add the page to your watchlist
  • unwatch: Remove the page from your watchlist
  • oldimage: The name of the old image to delete as provided by iiprop=archivename

Example[edit | edit source]

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

Deleting the Main Page with an auto-generated reason

Possible errors[edit | edit source]

In addition to the usual stuff:

Code Info
notitle The title parameter must be set
notoken The token parameter must be set
permissiondenied You don't have permission to delete pages
Note: On most wikis, deleting pages is restricted to sysops, but other wikis may have stricter rules.
cantdelete Couldn't delete "title". Maybe it was deleted already by someone else