API:Options

POST request to change preferences of the current user.

API documentation
{| style="color: black; background-color: #ffff; border-spacing: 1px; border: 1px solid darkgray;"

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

  Log in, via one of the methods described on.   Get an.   Send a POST request, with the CSRF token, to take action on a page.  

The sample code below covers the final step in detail.

Available options
* : 0
 * : 1
 * : 1
 * : 1
 * : 0
 * : True
 * : False
 * : False
 * : True
 * : 0
 * : False
 * : 1
 * : 0
 * : 0
 * : False
 * : 0
 * : 0
 * : 0
 * : 0
 * : wikitext
 * : 1
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : remember-last
 * : 0
 * : mathml
 * : True
 * : False
 * : True
 * : True
 * : False
 * : True
 * : 0
 * : False
 * : True
 * : False
 * : 0
 * : 1
 * : 1
 * : 1
 * : 1
 * : 1
 * : 0
 * : 1
 * : 1
 * : False
 * : 1
 * : 0
 * : 0
 * : 1
 * : True
 * : False
 * : True
 * : notshown
 * : False
 * : 0
 * : 0
 * : True
 * : True
 * : True
 * : True
 * : False
 * : soft
 * : soft
 * : False
 * : False
 * : False
 * : 0
 * : None
 * : 0
 * : default
 * : 0
 * : 0
 * : monospace
 * : 0
 * : 0
 * : 1
 * : False
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : unknown
 * : 0
 * : 0
 * : 1
 * : 2
 * : 0
 * : 0
 * : 1
 * : 0
 * : 0
 * : 1
 * : 7
 * : 0
 * : 50
 * : True
 * : Search
 * : 20
 * : True
 * : False
 * : 1
 * : 0
 * : vector
 * : 4
 * : 2
 * : 0
 * : 0
 * : True
 * : 0
 * : 0
 * : 1
 * : 3
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 1
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 250
 * : 1
 * : 1
 * : 0
 * : 1
 * : 1
 * : 1
 * : 1
 * : System|0
 * : 1
 * : 1
 * : 1
 * : 1
 * : 1
 * : 1
 * : 1
 * : 1
 * : en
 * : en
 * : ban
 * : en
 * : crh
 * : gan
 * : iu
 * : kk
 * : ku
 * : sh-latn
 * : shi
 * : sr
 * : tg
 * : tly
 * : uz
 * : zh
 * : 1
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 1
 * : 0
 * : 0
 * : 1
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 1
 * : 1
 * : 0
 * : 0
 * : 1
 * : 1
 * : 1
 * : 1
 * : 1
 * : 0
 * : 1
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 1
 * : 0
 * : 1
 * : 1
 * : 1
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 1
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 1
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : 0
 * : fuzzy
 * : 0
 * : html
 * : True
 * : True
 * : True
 * : False
 * : True
 * : True
 * : False
 * : True
 * : True
 * : True
 * : True
 * : True
 * : False
 * : True
 * : True
 * : 0
 * : True
 * : True
 * : False
 * : True
 * : True
 * : False
 * : False
 * : False
 * : False
 * : True
 * : True
 * : False
 * : False
 * : False
 * : False
 * : False
 * : False
 * : False
 * : True
 * : True
 * : False
 * : True
 * : True
 * : True
 * : True
 * : True
 * : True
 * : False
 * : True
 * : True
 * : False
 * : True
 * : True
 * : False
 * : True
 * : False
 * : True
 * : True
 * : False
 * : True
 * : True
 * : False
 * : True
 * : {"vector":{"link-recommendation":true,"image-recommendation":true},"minerva":{"link-recommendation":true,"image-recommendation":true}}
 * : OR
 * : False
 * : False
 * : True
 * : True
 * : True
 * : True
 * : False
 * : 0
 * : None
 * : {"usersToShow":10,"filters":{"minedits":1,"maxedits":500}}
 * : 1
 * : 2
 * : 0
 * : None
 * : {"usersToShow":10,"filters":{"minedits":1,"maxedits":500}}
 * : 1
 * : 2

Possible errors
In addition to :

Parameter history

 * 1.21: Introduced

Additional notes

 * This API is primarily intended for changing options which are registered by MediaWiki core or extensions and available on Special:Preferences.
 * You can also use the API to set arbitrary user options that can be used by user scripts or external editors. These options must begin with the prefix.
 * There is currently no limit on the number of user options you can set at once. You can store data within a user option by encoding it as a string.
 * Providing only names of options without equal sign results in resetting them (e.g. ). In the case of an arbitrary  key/value pair, the resetting results in its deletion.
 * The parameter cannot be used to set a value which contains a pipe character , as it is used by the API to separate options. If you need to set such a value (e.g., a user signature) use an  &  pair.
 * The following limits apply to all user options:
 * The byte length of the key must be <= 255.
 * The byte length of the value must be <= 65535.
 * The key must consist only of ASCII letters, numbers, hyphens and underscores (a-z, A-Z, 0-9, _, -).