API:Watch

POST request to add or remove pages from a watchlist.

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


 * 1. Log in, via one of the methods described on API:Login.


 * 2. GET a CSRF token.


 * The sample query above is for wikis running v1.24+.


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




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

The sample code below covers the final step in detail.

Sample code
watch.py

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 "Edit your watchlist" 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 Action API, whereas watchlist tokens are used specifically to view another user's watchlist.
 * Unlike API:Watchlist, 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.