API:Watch

POST request to add or remove pages from a watchlist.

Example
Making any POST request is a multi-step process:

  Log in, via one of the methods described on.   GET a.

The sample query above is for wikis running MediaWiki 1.24+.

For wikis running earlier versions of MediaWiki, tokens for this operation can be obtained via with  ( MediaWiki 1.20+ ), or by using the following query:

  Send a POST request, with the CSRF token, to take action on a page.  

The sample code below covers the final step in detail.

Parameter history

 * v1.25: Deprecated
 * v1.23:
 * Introduced
 * Deprecated
 * v1.21: Introduced

Additional notes

 * When running the sample code via a bot, make sure that the bot has the   option set to , by visiting the Special:BotPasswords page.


 * This module uses CSRF tokens, not watchlist tokens. CSRF tokens are generally used for POST requests and wiki-modifying actions throughout the , whereas watchlist tokens are used specifically to view another user's watchlist.


 * Unlike, which allows you to read an account's private watchlist without logging in, this module requires you to log directly into the account you want to alter.