API:Watch/en

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.

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  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.