Notifications/API

Notifications Portal
About
Notifications Rollout and plans
Documentation
Glossary General documentation Types of notifications Cross-wiki notifications Special:Notifications page
Technical
Extension Developer guide Public API
Create a new notification
Design guide Create a new notification type Document a new notification type

meta=notifications (not)

(main | query | notifications)

• This module requires read rights.
• Source: Echo
• License: MIT

Get notifications waiting for the current user.

• https://www.mediawiki.org/wiki/Special:MyLanguage/Echo_(Notifications)/API

Parameters:

notwikis

List of wikis to fetch notifications from (defaults to only current wiki).

Values (separate with | or alternative): aawiki, aawikibooks, aawiktionary, abwiki, abwiktionary, acewiki, advisorswiki, advisorywiki, adywiki, afwiki, afwikibooks, afwikiquote, afwiktionary, akwiki, akwikibooks, akwiktionary, alswiki, amwiki, amwikimedia, amwikiquote, amwiktionary, angwiki, angwikibooks, angwikiquote, angwikisource, angwiktionary, anwiki, anwiktionary, arbcom_cswiki, arbcom_dewiki, arbcom_enwiki, arbcom_fiwiki, arbcom_nlwiki, arcwiki, arwiki, arwikibooks, arwikimedia, arwikinews, arwikiquote, arwikisource, arwikiversity, arwiktionary, arzwiki, astwiki, astwikibooks, astwikiquote, astwiktionary, aswiki, aswikibooks, aswikisource, aswiktionary, atjwiki, auditcomwiki, avwiki, avwiktionary, aywiki, aywikibooks, aywiktionary, azbwiki, azwiki, azwikibooks, azwikiquote, azwikisource, azwiktionary, barwiki, bat_smgwiki, bawiki, bawikibooks, bclwiki, bdwikimedia, be_x_oldwiki, betawikiversity, bewiki, bewikibooks, bewikimedia, bewikiquote, bewikisource, bewiktionary, bgwiki, bgwikibooks, bgwikinews, bgwikiquote, bgwikisource, bgwiktionary, bhwiki, bhwiktionary, biwiki, biwikibooks, biwiktionary, bjnwiki, bmwiki, bmwikibooks, bmwikiquote, bmwiktionary, bnwiki, bnwikibooks, bnwikisource, bnwikivoyage, bnwiktionary, boardgovcomwiki, boardwiki, bowiki, bowikibooks, bowiktionary, bpywiki, brwiki, brwikimedia, brwikiquote, brwikisource, brwiktionary, bswiki, bswikibooks, bswikinews, bswikiquote, bswikisource, bswiktionary, bugwiki, bxrwiki, cawiki, cawikibooks, cawikimedia, cawikinews, cawikiquote, cawikisource, cawiktionary, cbk_zamwiki, cdowiki, cebwiki, cewiki, chairwiki, chapcomwiki, checkuserwiki, chowiki, chrwiki, chrwiktionary, chwiki, chwikibooks, chwiktionary, chywiki, ckbwiki, cnwikimedia, collabwiki, commonswiki, cowiki, cowikibooks, cowikimedia, cowikiquote, cowiktionary, crhwiki, crwiki, crwikiquote, crwiktionary, csbwiki, csbwiktionary, cswiki, cswikibooks, cswikinews, cswikiquote, cswikisource, cswikiversity, cswiktionary, cuwiki, cvwiki, cvwikibooks, cywiki, cywikibooks, cywikiquote, cywikisource, cywiktionary, dawiki, dawikibooks, dawikiquote, dawikisource, dawiktionary, dewiki, dewikibooks, dewikinews, dewikiquote, dewikisource, dewikiversity, dewikivoyage, dewiktionary, dinwiki, diqwiki, dkwikimedia, donatewiki, dsbwiki, dtywiki, dvwiki, dvwiktionary, dzwiki, dzwiktionary, ecwikimedia, eewiki, electcomwiki, elwiki, elwikibooks, elwikinews, elwikiquote, elwikisource, elwikiversity, elwikivoyage, elwiktionary, emlwiki, enwiki, enwikibooks, enwikinews, enwikiquote, enwikisource, enwikiversity, enwikivoyage, enwiktionary, eowiki, eowikibooks, eowikinews, eowikiquote, eowikisource, eowiktionary, eswiki, eswikibooks, eswikinews, eswikiquote, eswikisource, eswikiversity, eswikivoyage, eswiktionary, etwiki, etwikibooks, etwikimedia, etwikiquote, etwikisource, etwiktionary, euwiki, euwikibooks, euwikiquote, euwikisource, euwiktionary, execwiki, extwiki, fawiki, fawikibooks, fawikinews, fawikiquote, fawikisource, fawikivoyage, fawiktionary, fdcwiki, ffwiki, fiu_vrowiki, fiwiki, fiwikibooks, fiwikimedia, fiwikinews, fiwikiquote, fiwikisource, fiwikiversity, fiwikivoyage, fiwiktionary, fixcopyrightwiki, fjwiki, fjwiktionary, foundationwiki, fowiki, fowikisource, fowiktionary, frpwiki, frrwiki, frwiki, frwikibooks, frwikinews, frwikiquote, frwikisource, frwikiversity, frwikivoyage, frwiktionary, furwiki, fywiki, fywikibooks, fywiktionary, gagwiki, ganwiki, gawiki, gawikibooks, gawikiquote, gawiktionary, gdwiki, gdwiktionary, glkwiki, glwiki, glwikibooks, glwikiquote, glwikisource, glwiktionary, gnwiki, gnwikibooks, gnwiktionary, gomwiki, gorwiki, gotwiki, gotwikibooks, grantswiki, guwiki, guwikibooks, guwikiquote, guwikisource, guwiktionary, gvwiki, gvwiktionary, hakwiki, hawiki, hawiktionary, hawwiki, hewiki, hewikibooks, hewikinews, hewikiquote, hewikisource, hewikivoyage, hewiktionary, hifwiki, hifwiktionary, hiwiki, hiwikibooks, hiwikimedia, hiwikiquote, hiwikiversity, hiwikivoyage, hiwiktionary, howiki, hrwiki, hrwikibooks, hrwikiquote, hrwikisource, hrwiktionary, hsbwiki, hsbwiktionary, htwiki, htwikisource, huwiki, huwikibooks, huwikinews, huwikiquote, huwikisource, huwiktionary, hywiki, hywikibooks, hywikiquote, hywikisource, hywiktionary, hywwiki, hzwiki, iawiki, iawikibooks, iawiktionary, id_internalwikimedia, idwiki, idwikibooks, idwikimedia, idwikiquote, idwikisource, idwiktionary, iegcomwiki, iewiki, iewikibooks, iewiktionary, igwiki, iiwiki, ikwiki, ikwiktionary, ilowiki, ilwikimedia, incubatorwiki, inhwiki, internalwiki, iowiki, iowiktionary, iswiki, iswikibooks, iswikiquote, iswikisource, iswiktionary, itwiki, itwikibooks, itwikinews, itwikiquote, itwikisource, itwikiversity, itwikivoyage, itwiktionary, iuwiki, iuwiktionary, jamwiki, jawiki, jawikibooks, jawikinews, jawikiquote, jawikisource, jawikiversity, jawiktionary, jbowiki, jbowiktionary, jvwiki, jvwiktionary, kaawiki, kabwiki, kawiki, kawikibooks, kawikiquote, kawiktionary, kbdwiki, kbpwiki, kgwiki, kiwiki, kjwiki, kkwiki, kkwikibooks, kkwikiquote, kkwiktionary, klwiki, klwiktionary, kmwiki, kmwikibooks, kmwiktionary, knwiki, knwikibooks, knwikiquote, knwikisource, knwiktionary, koiwiki, kowiki, kowikibooks, kowikinews, kowikiquote, kowikisource, kowikiversity, kowiktionary, krcwiki, krwiki, krwikiquote, kshwiki, kswiki, kswikibooks, kswikiquote, kswiktionary, kuwiki, kuwikibooks, kuwikiquote, kuwiktionary, kvwiki, kwwiki, kwwikiquote, kwwiktionary, kywiki, kywikibooks, kywikiquote, kywiktionary, labswiki, labtestwiki, ladwiki, lawiki, lawikibooks, lawikiquote, lawikisource, lawiktionary, lbewiki, lbwiki, lbwikibooks, lbwikiquote, lbwiktionary, legalteamwiki, lezwiki, lfnwiki, lgwiki, lijwiki, liwiki, liwikibooks, liwikinews, liwikiquote, liwikisource, liwiktionary, lmowiki, lnwiki, lnwikibooks, lnwiktionary, loginwiki, lowiki, lowiktionary, lrcwiki, ltgwiki, ltwiki, ltwikibooks, ltwikiquote, ltwikisource, ltwiktionary, lvwiki, lvwikibooks, lvwiktionary, maiwiki, maiwikimedia, map_bmswiki, mdfwiki, mediawikiwiki, metawiki, mgwiki, mgwikibooks, mgwiktionary, mhrwiki, mhwiki, mhwiktionary, minwiki, miwiki, miwikibooks, miwiktionary, mkwiki, mkwikibooks, mkwikimedia, mkwikisource, mkwiktionary, mlwiki, mlwikibooks, mlwikiquote, mlwikisource, mlwiktionary, mnwiki, mnwikibooks, mnwiktionary, movementroleswiki, mrjwiki, mrwiki, mrwikibooks, mrwikiquote, mrwikisource, mrwiktionary, mswiki, mswikibooks, mswiktionary, mtwiki, mtwiktionary, muswiki, mwlwiki, mxwikimedia, myvwiki, mywiki, mywikibooks, mywiktionary, mznwiki, nahwiki, nahwikibooks, nahwiktionary, napwiki, napwikisource, nawiki, nawikibooks, nawikiquote, nawiktionary, nds_nlwiki, ndswiki, ndswikibooks, ndswikiquote, ndswiktionary, newiki, newikibooks, newiktionary, newwiki, ngwiki, nlwiki, nlwikibooks, nlwikimedia, nlwikinews, nlwikiquote, nlwikisource, nlwikivoyage, nlwiktionary, nnwiki, nnwikiquote, nnwiktionary, noboard_chapterswikimedia, nostalgiawiki, novwiki, nowiki, nowikibooks, nowikimedia, nowikinews, nowikiquote, nowikisource, nowiktionary, nrmwiki, nsowiki, nvwiki, nycwikimedia, nywiki, nzwikimedia, ocwiki, ocwikibooks, ocwiktionary, officewiki, olowiki, ombudsmenwiki, omwiki, omwiktionary, orwiki, orwikisource, orwiktionary, oswiki, otrs_wikiwiki, outreachwiki, pa_uswikimedia, pagwiki, pamwiki, papwiki, pawiki, pawikibooks, pawikisource, pawiktionary, pcdwiki, pdcwiki, pflwiki, pihwiki, piwiki, piwiktionary, plwiki, plwikibooks, plwikimedia, plwikinews, plwikiquote, plwikisource, plwikivoyage, plwiktionary, pmswiki, pmswikisource, pnbwiki, pnbwiktionary, pntwiki, projectcomwiki, pswiki, pswikibooks, pswikivoyage, pswiktionary, ptwiki, ptwikibooks, ptwikimedia, ptwikinews, ptwikiquote, ptwikisource, ptwikiversity, ptwikivoyage, ptwiktionary, punjabiwikimedia, qualitywiki, quwiki, quwikibooks, quwikiquote, quwiktionary, rmwiki, rmwikibooks, rmwiktionary, rmywiki, rnwiki, rnwiktionary, roa_rupwiki, roa_rupwiktionary, roa_tarawiki, romdwikimedia, rowiki, rowikibooks, rowikinews, rowikiquote, rowikisource, rowikivoyage, rowiktionary, rswikimedia, ruewiki, ruwiki, ruwikibooks, ruwikimedia, ruwikinews, ruwikiquote, ruwikisource, ruwikiversity, ruwikivoyage, ruwiktionary, rwwiki, rwwiktionary, sahwiki, sahwikiquote, sahwikisource, satwiki, sawiki, sawikibooks, sawikiquote, sawikisource, sawiktionary, scnwiki, scnwiktionary, scowiki, scwiki, scwiktionary, sdwiki, sdwikinews, sdwiktionary, searchcomwiki, sewiki, sewikibooks, sewikimedia, sgwiki, sgwiktionary, shnwiki, shwiki, shwiktionary, simplewiki, simplewikibooks, simplewikiquote, simplewiktionary, siwiki, siwikibooks, siwiktionary, skwiki, skwikibooks, skwikiquote, skwikisource, skwiktionary, slwiki, slwikibooks, slwikiquote, slwikisource, slwikiversity, slwiktionary, smwiki, smwiktionary, snwiki, snwiktionary, sourceswiki, sowiki, sowiktionary, spcomwiki, specieswiki, sqwiki, sqwikibooks, sqwikinews, sqwikiquote, sqwiktionary, srnwiki, srwiki, srwikibooks, srwikinews, srwikiquote, srwikisource, srwiktionary, sswiki, sswiktionary, stewardwiki, stqwiki, strategywiki, stwiki, stwiktionary, suwiki, suwikibooks, suwikiquote, suwiktionary, svwiki, svwikibooks, svwikinews, svwikiquote, svwikisource, svwikiversity, svwikivoyage, svwiktionary, swwiki, swwikibooks, swwiktionary, szlwiki, tawiki, tawikibooks, tawikinews, tawikiquote, tawikisource, tawiktionary, tcywiki, techconductwiki, tenwiki, test2wiki, testcommonswiki, testwiki, testwikidatawiki, tetwiki, tewiki, tewikibooks, tewikiquote, tewikisource, tewiktionary, tgwiki, tgwikibooks, tgwiktionary, thwiki, thwikibooks, thwikinews, thwikiquote, thwikisource, thwiktionary, tiwiki, tiwiktionary, tkwiki, tkwikibooks, tkwikiquote, tkwiktionary, tlwiki, tlwikibooks, tlwiktionary, tnwiki, tnwiktionary, towiki, towiktionary, tpiwiki, tpiwiktionary, transitionteamwiki, trwiki, trwikibooks, trwikimedia, trwikinews, trwikiquote, trwikisource, trwiktionary, tswiki, tswiktionary, ttwiki, ttwikibooks, ttwikiquote, ttwiktionary, tumwiki, twwiki, twwiktionary, tyvwiki, tywiki, uawikimedia, udmwiki, ugwiki, ugwikibooks, ugwikiquote, ugwiktionary, ukwiki, ukwikibooks, ukwikinews, ukwikiquote, ukwikisource, ukwikivoyage, ukwiktionary, urwiki, urwikibooks, urwikiquote, urwiktionary, usabilitywiki, uzwiki, uzwikibooks, uzwikiquote, uzwiktionary, vecwiki, vecwikisource, vecwiktionary, vepwiki, vewiki, viwiki, viwikibooks, viwikiquote, viwikisource, viwikivoyage, viwiktionary, vlswiki, votewiki, vowiki, vowikibooks, vowikiquote, vowiktionary, warwiki, wawiki, wawikibooks, wawiktionary, wbwikimedia, wg_enwiki, wikidatawiki, wikimania2005wiki, wikimania2006wiki, wikimania2007wiki, wikimania2008wiki, wikimania2009wiki, wikimania2010wiki, wikimania2011wiki, wikimania2012wiki, wikimania2013wiki, wikimania2014wiki, wikimania2015wiki, wikimania2016wiki, wikimania2017wiki, wikimania2018wiki, wikimaniateamwiki, wikimaniawiki, wowiki, wowikiquote, wowiktionary, wuuwiki, xalwiki, xhwiki, xhwikibooks, xhwiktionary, xmfwiki, yiwiki, yiwikisource, yiwiktionary, yowiki, yowikibooks, yowiktionary, yuewiktionary, zawiki, zawikibooks, zawikiquote, zawiktionary, zeawiki, zh_classicalwiki, zh_min_nanwiki, zh_min_nanwikibooks, zh_min_nanwikiquote, zh_min_nanwikisource, zh_min_nanwiktionary, zh_yuewiki, zhwiki, zhwikibooks, zhwikinews, zhwikiquote, zhwikisource, zhwikiversity, zhwikivoyage, zhwiktionary, zuwiki, zuwikibooks, zuwiktionary, *

Maximum number of values is 50 (500 for bots).

Default: mediawikiwiki

notfilter

Filter notifications returned.

Values (separate with | or alternative): read, !read

Default: read|!read

notprop

Details to request.

Values (separate with | or alternative): list, count, seenTime

Default: list

notsections

The notification sections to query (i.e. some combination of 'alert' and 'message').

Values (separate with | or alternative): alert, message

Default: alert|message

notgroupbysection

Whether to group the result by section. Each section is fetched separately if set.

Type: boolean (details)

notformat

If specified, notifications will be returned formatted this way.

model

Raw notification data

special

Formatted for Special:Notifications page (and only that!) Do not rely on the HTML as it may change at any given time.

flyout

Deprecated. Use notformat=model for raw data

html

Deprecated. Use notformat=model for raw data

One of the following values: model, special, flyout, html

notlimit

The maximum number of notifications to return.

No more than 50 (500 for bots) allowed.

Type: integer or max

Default: 20

notcontinue

When more results are available, use this to continue.

notunreadfirst

Whether to show unread notifications first (only used if groupbysection is not set).

Type: boolean (details)

nottitles

Only return notifications for these pages. To get notifications not associated with any page, use [] as a title.

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

notbundle

Whether to show bundle compatible unread notifications according to notification types bundling rules.

Type: boolean (details)

notalertcontinue

When more alert results are available, use this to continue.

notalertunreadfirst

Whether to show unread message notifications first (only used if groupbysection is set).

Type: boolean (details)

notmessagecontinue

When more message results are available, use this to continue.

notmessageunreadfirst

Whether to show unread alert notifications first (only used if groupbysection is set).

Type: boolean (details)

notcrosswikisummary

True to opt in to a summary notification of notifications on foreign wikis.

Type: boolean (details)

Examples:

List notifications

api.php?action=query&meta=notifications [open in sandbox]

List notifications, grouped by section, with counts

api.php?action=query&meta=notifications&notprop=count&notsections=alert|message&notgroupbysection=1 [open in sandbox]

Example

api.php?action=query&meta=notifications [try in ApiSandbox]

action=echomarkread

(main | echomarkread)

• This module requires read rights.
• This module requires write rights.
• This module only accepts POST requests.
• Source: Echo
• License: MIT

Mark notifications as read for the current user.

• https://www.mediawiki.org/wiki/Special:MyLanguage/Echo_(Notifications)/API

Parameters:

wikis

⧼apihelp-echomarkread-param-wikis⧽

Values (separate with | or alternative): aawiki, aawikibooks, aawiktionary, abwiki, abwiktionary, acewiki, advisorswiki, advisorywiki, adywiki, afwiki, afwikibooks, afwikiquote, afwiktionary, akwiki, akwikibooks, akwiktionary, alswiki, amwiki, amwikimedia, amwikiquote, amwiktionary, angwiki, angwikibooks, angwikiquote, angwikisource, angwiktionary, anwiki, anwiktionary, arbcom_cswiki, arbcom_dewiki, arbcom_enwiki, arbcom_fiwiki, arbcom_nlwiki, arcwiki, arwiki, arwikibooks, arwikimedia, arwikinews, arwikiquote, arwikisource, arwikiversity, arwiktionary, arzwiki, astwiki, astwikibooks, astwikiquote, astwiktionary, aswiki, aswikibooks, aswikisource, aswiktionary, atjwiki, auditcomwiki, avwiki, avwiktionary, aywiki, aywikibooks, aywiktionary, azbwiki, azwiki, azwikibooks, azwikiquote, azwikisource, azwiktionary, barwiki, bat_smgwiki, bawiki, bawikibooks, bclwiki, bdwikimedia, be_x_oldwiki, betawikiversity, bewiki, bewikibooks, bewikimedia, bewikiquote, bewikisource, bewiktionary, bgwiki, bgwikibooks, bgwikinews, bgwikiquote, bgwikisource, bgwiktionary, bhwiki, bhwiktionary, biwiki, biwikibooks, biwiktionary, bjnwiki, bmwiki, bmwikibooks, bmwikiquote, bmwiktionary, bnwiki, bnwikibooks, bnwikisource, bnwikivoyage, bnwiktionary, boardgovcomwiki, boardwiki, bowiki, bowikibooks, bowiktionary, bpywiki, brwiki, brwikimedia, brwikiquote, brwikisource, brwiktionary, bswiki, bswikibooks, bswikinews, bswikiquote, bswikisource, bswiktionary, bugwiki, bxrwiki, cawiki, cawikibooks, cawikimedia, cawikinews, cawikiquote, cawikisource, cawiktionary, cbk_zamwiki, cdowiki, cebwiki, cewiki, chairwiki, chapcomwiki, checkuserwiki, chowiki, chrwiki, chrwiktionary, chwiki, chwikibooks, chwiktionary, chywiki, ckbwiki, cnwikimedia, collabwiki, commonswiki, cowiki, cowikibooks, cowikimedia, cowikiquote, cowiktionary, crhwiki, crwiki, crwikiquote, crwiktionary, csbwiki, csbwiktionary, cswiki, cswikibooks, cswikinews, cswikiquote, cswikisource, cswikiversity, cswiktionary, cuwiki, cvwiki, cvwikibooks, cywiki, cywikibooks, cywikiquote, cywikisource, cywiktionary, dawiki, dawikibooks, dawikiquote, dawikisource, dawiktionary, dewiki, dewikibooks, dewikinews, dewikiquote, dewikisource, dewikiversity, dewikivoyage, dewiktionary, dinwiki, diqwiki, dkwikimedia, donatewiki, dsbwiki, dtywiki, dvwiki, dvwiktionary, dzwiki, dzwiktionary, ecwikimedia, eewiki, electcomwiki, elwiki, elwikibooks, elwikinews, elwikiquote, elwikisource, elwikiversity, elwikivoyage, elwiktionary, emlwiki, enwiki, enwikibooks, enwikinews, enwikiquote, enwikisource, enwikiversity, enwikivoyage, enwiktionary, eowiki, eowikibooks, eowikinews, eowikiquote, eowikisource, eowiktionary, eswiki, eswikibooks, eswikinews, eswikiquote, eswikisource, eswikiversity, eswikivoyage, eswiktionary, etwiki, etwikibooks, etwikimedia, etwikiquote, etwikisource, etwiktionary, euwiki, euwikibooks, euwikiquote, euwikisource, euwiktionary, execwiki, extwiki, fawiki, fawikibooks, fawikinews, fawikiquote, fawikisource, fawikivoyage, fawiktionary, fdcwiki, ffwiki, fiu_vrowiki, fiwiki, fiwikibooks, fiwikimedia, fiwikinews, fiwikiquote, fiwikisource, fiwikiversity, fiwikivoyage, fiwiktionary, fixcopyrightwiki, fjwiki, fjwiktionary, foundationwiki, fowiki, fowikisource, fowiktionary, frpwiki, frrwiki, frwiki, frwikibooks, frwikinews, frwikiquote, frwikisource, frwikiversity, frwikivoyage, frwiktionary, furwiki, fywiki, fywikibooks, fywiktionary, gagwiki, ganwiki, gawiki, gawikibooks, gawikiquote, gawiktionary, gdwiki, gdwiktionary, glkwiki, glwiki, glwikibooks, glwikiquote, glwikisource, glwiktionary, gnwiki, gnwikibooks, gnwiktionary, gomwiki, gorwiki, gotwiki, gotwikibooks, grantswiki, guwiki, guwikibooks, guwikiquote, guwikisource, guwiktionary, gvwiki, gvwiktionary, hakwiki, hawiki, hawiktionary, hawwiki, hewiki, hewikibooks, hewikinews, hewikiquote, hewikisource, hewikivoyage, hewiktionary, hifwiki, hifwiktionary, hiwiki, hiwikibooks, hiwikimedia, hiwikiquote, hiwikiversity, hiwikivoyage, hiwiktionary, howiki, hrwiki, hrwikibooks, hrwikiquote, hrwikisource, hrwiktionary, hsbwiki, hsbwiktionary, htwiki, htwikisource, huwiki, huwikibooks, huwikinews, huwikiquote, huwikisource, huwiktionary, hywiki, hywikibooks, hywikiquote, hywikisource, hywiktionary, hywwiki, hzwiki, iawiki, iawikibooks, iawiktionary, id_internalwikimedia, idwiki, idwikibooks, idwikimedia, idwikiquote, idwikisource, idwiktionary, iegcomwiki, iewiki, iewikibooks, iewiktionary, igwiki, iiwiki, ikwiki, ikwiktionary, ilowiki, ilwikimedia, incubatorwiki, inhwiki, internalwiki, iowiki, iowiktionary, iswiki, iswikibooks, iswikiquote, iswikisource, iswiktionary, itwiki, itwikibooks, itwikinews, itwikiquote, itwikisource, itwikiversity, itwikivoyage, itwiktionary, iuwiki, iuwiktionary, jamwiki, jawiki, jawikibooks, jawikinews, jawikiquote, jawikisource, jawikiversity, jawiktionary, jbowiki, jbowiktionary, jvwiki, jvwiktionary, kaawiki, kabwiki, kawiki, kawikibooks, kawikiquote, kawiktionary, kbdwiki, kbpwiki, kgwiki, kiwiki, kjwiki, kkwiki, kkwikibooks, kkwikiquote, kkwiktionary, klwiki, klwiktionary, kmwiki, kmwikibooks, kmwiktionary, knwiki, knwikibooks, knwikiquote, knwikisource, knwiktionary, koiwiki, kowiki, kowikibooks, kowikinews, kowikiquote, kowikisource, kowikiversity, kowiktionary, krcwiki, krwiki, krwikiquote, kshwiki, kswiki, kswikibooks, kswikiquote, kswiktionary, kuwiki, kuwikibooks, kuwikiquote, kuwiktionary, kvwiki, kwwiki, kwwikiquote, kwwiktionary, kywiki, kywikibooks, kywikiquote, kywiktionary, labswiki, labtestwiki, ladwiki, lawiki, lawikibooks, lawikiquote, lawikisource, lawiktionary, lbewiki, lbwiki, lbwikibooks, lbwikiquote, lbwiktionary, legalteamwiki, lezwiki, lfnwiki, lgwiki, lijwiki, liwiki, liwikibooks, liwikinews, liwikiquote, liwikisource, liwiktionary, lmowiki, lnwiki, lnwikibooks, lnwiktionary, loginwiki, lowiki, lowiktionary, lrcwiki, ltgwiki, ltwiki, ltwikibooks, ltwikiquote, ltwikisource, ltwiktionary, lvwiki, lvwikibooks, lvwiktionary, maiwiki, maiwikimedia, map_bmswiki, mdfwiki, mediawikiwiki, metawiki, mgwiki, mgwikibooks, mgwiktionary, mhrwiki, mhwiki, mhwiktionary, minwiki, miwiki, miwikibooks, miwiktionary, mkwiki, mkwikibooks, mkwikimedia, mkwikisource, mkwiktionary, mlwiki, mlwikibooks, mlwikiquote, mlwikisource, mlwiktionary, mnwiki, mnwikibooks, mnwiktionary, movementroleswiki, mrjwiki, mrwiki, mrwikibooks, mrwikiquote, mrwikisource, mrwiktionary, mswiki, mswikibooks, mswiktionary, mtwiki, mtwiktionary, muswiki, mwlwiki, mxwikimedia, myvwiki, mywiki, mywikibooks, mywiktionary, mznwiki, nahwiki, nahwikibooks, nahwiktionary, napwiki, napwikisource, nawiki, nawikibooks, nawikiquote, nawiktionary, nds_nlwiki, ndswiki, ndswikibooks, ndswikiquote, ndswiktionary, newiki, newikibooks, newiktionary, newwiki, ngwiki, nlwiki, nlwikibooks, nlwikimedia, nlwikinews, nlwikiquote, nlwikisource, nlwikivoyage, nlwiktionary, nnwiki, nnwikiquote, nnwiktionary, noboard_chapterswikimedia, nostalgiawiki, novwiki, nowiki, nowikibooks, nowikimedia, nowikinews, nowikiquote, nowikisource, nowiktionary, nrmwiki, nsowiki, nvwiki, nycwikimedia, nywiki, nzwikimedia, ocwiki, ocwikibooks, ocwiktionary, officewiki, olowiki, ombudsmenwiki, omwiki, omwiktionary, orwiki, orwikisource, orwiktionary, oswiki, otrs_wikiwiki, outreachwiki, pa_uswikimedia, pagwiki, pamwiki, papwiki, pawiki, pawikibooks, pawikisource, pawiktionary, pcdwiki, pdcwiki, pflwiki, pihwiki, piwiki, piwiktionary, plwiki, plwikibooks, plwikimedia, plwikinews, plwikiquote, plwikisource, plwikivoyage, plwiktionary, pmswiki, pmswikisource, pnbwiki, pnbwiktionary, pntwiki, projectcomwiki, pswiki, pswikibooks, pswikivoyage, pswiktionary, ptwiki, ptwikibooks, ptwikimedia, ptwikinews, ptwikiquote, ptwikisource, ptwikiversity, ptwikivoyage, ptwiktionary, punjabiwikimedia, qualitywiki, quwiki, quwikibooks, quwikiquote, quwiktionary, rmwiki, rmwikibooks, rmwiktionary, rmywiki, rnwiki, rnwiktionary, roa_rupwiki, roa_rupwiktionary, roa_tarawiki, romdwikimedia, rowiki, rowikibooks, rowikinews, rowikiquote, rowikisource, rowikivoyage, rowiktionary, rswikimedia, ruewiki, ruwiki, ruwikibooks, ruwikimedia, ruwikinews, ruwikiquote, ruwikisource, ruwikiversity, ruwikivoyage, ruwiktionary, rwwiki, rwwiktionary, sahwiki, sahwikiquote, sahwikisource, satwiki, sawiki, sawikibooks, sawikiquote, sawikisource, sawiktionary, scnwiki, scnwiktionary, scowiki, scwiki, scwiktionary, sdwiki, sdwikinews, sdwiktionary, searchcomwiki, sewiki, sewikibooks, sewikimedia, sgwiki, sgwiktionary, shnwiki, shwiki, shwiktionary, simplewiki, simplewikibooks, simplewikiquote, simplewiktionary, siwiki, siwikibooks, siwiktionary, skwiki, skwikibooks, skwikiquote, skwikisource, skwiktionary, slwiki, slwikibooks, slwikiquote, slwikisource, slwikiversity, slwiktionary, smwiki, smwiktionary, snwiki, snwiktionary, sourceswiki, sowiki, sowiktionary, spcomwiki, specieswiki, sqwiki, sqwikibooks, sqwikinews, sqwikiquote, sqwiktionary, srnwiki, srwiki, srwikibooks, srwikinews, srwikiquote, srwikisource, srwiktionary, sswiki, sswiktionary, stewardwiki, stqwiki, strategywiki, stwiki, stwiktionary, suwiki, suwikibooks, suwikiquote, suwiktionary, svwiki, svwikibooks, svwikinews, svwikiquote, svwikisource, svwikiversity, svwikivoyage, svwiktionary, swwiki, swwikibooks, swwiktionary, szlwiki, tawiki, tawikibooks, tawikinews, tawikiquote, tawikisource, tawiktionary, tcywiki, techconductwiki, tenwiki, test2wiki, testcommonswiki, testwiki, testwikidatawiki, tetwiki, tewiki, tewikibooks, tewikiquote, tewikisource, tewiktionary, tgwiki, tgwikibooks, tgwiktionary, thwiki, thwikibooks, thwikinews, thwikiquote, thwikisource, thwiktionary, tiwiki, tiwiktionary, tkwiki, tkwikibooks, tkwikiquote, tkwiktionary, tlwiki, tlwikibooks, tlwiktionary, tnwiki, tnwiktionary, towiki, towiktionary, tpiwiki, tpiwiktionary, transitionteamwiki, trwiki, trwikibooks, trwikimedia, trwikinews, trwikiquote, trwikisource, trwiktionary, tswiki, tswiktionary, ttwiki, ttwikibooks, ttwikiquote, ttwiktionary, tumwiki, twwiki, twwiktionary, tyvwiki, tywiki, uawikimedia, udmwiki, ugwiki, ugwikibooks, ugwikiquote, ugwiktionary, ukwiki, ukwikibooks, ukwikinews, ukwikiquote, ukwikisource, ukwikivoyage, ukwiktionary, urwiki, urwikibooks, urwikiquote, urwiktionary, usabilitywiki, uzwiki, uzwikibooks, uzwikiquote, uzwiktionary, vecwiki, vecwikisource, vecwiktionary, vepwiki, vewiki, viwiki, viwikibooks, viwikiquote, viwikisource, viwikivoyage, viwiktionary, vlswiki, votewiki, vowiki, vowikibooks, vowikiquote, vowiktionary, warwiki, wawiki, wawikibooks, wawiktionary, wbwikimedia, wg_enwiki, wikidatawiki, wikimania2005wiki, wikimania2006wiki, wikimania2007wiki, wikimania2008wiki, wikimania2009wiki, wikimania2010wiki, wikimania2011wiki, wikimania2012wiki, wikimania2013wiki, wikimania2014wiki, wikimania2015wiki, wikimania2016wiki, wikimania2017wiki, wikimania2018wiki, wikimaniateamwiki, wikimaniawiki, wowiki, wowikiquote, wowiktionary, wuuwiki, xalwiki, xhwiki, xhwikibooks, xhwiktionary, xmfwiki, yiwiki, yiwikisource, yiwiktionary, yowiki, yowikibooks, yowiktionary, yuewiktionary, zawiki, zawikibooks, zawikiquote, zawiktionary, zeawiki, zh_classicalwiki, zh_min_nanwiki, zh_min_nanwikibooks, zh_min_nanwikiquote, zh_min_nanwikisource, zh_min_nanwiktionary, zh_yuewiki, zhwiki, zhwikibooks, zhwikinews, zhwikiquote, zhwikisource, zhwikiversity, zhwikivoyage, zhwiktionary, zuwiki, zuwikibooks, zuwiktionary, *

Maximum number of values is 50 (500 for bots).

Default: mediawikiwiki

list

A list of notification IDs to mark as read.

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

unreadlist

A list of notification IDs to mark as unread.

Separate values with | or alternative. Maximum number of values is 50 (500 for bots).

all

If set, marks all of a user's notifications as read.

Type: boolean (details)

sections

A list of sections to mark as read.

Values (separate with | or alternative): alert, message

token

A "csrf" token retrieved from action=query&meta=tokens

This parameter is required.

Examples:

Mark notification 8 as read

api.php?action=echomarkread&list=8 [open in sandbox]

Mark all notifications as read

api.php?action=echomarkread&all=true [open in sandbox]

Mark notification 1 as unread

api.php?action=echomarkread&unreadlist=1 [open in sandbox]

Example

Note: In this example, all parameters are passed in a GET request just for the sake of simplicity. However, action=echomarkread requires POST requests.

api.php?action=echomarkread&all=1&token=TOKEN [try in ApiSandbox]

action=echomarkseen

(main | echomarkseen)

• This module requires read rights.
• This module requires write rights.
• This module only accepts POST requests.
• Source: Echo
• License: MIT

Mark notifications as seen for the current user.

• https://www.mediawiki.org/wiki/Special:MyLanguage/Echo_(Notifications)/API

Parameters:

token

A "csrf" token retrieved from action=query&meta=tokens

This parameter is required.

type

Type of notifications to mark as seen: 'alert', 'message' or 'all'.

This parameter is required.

One of the following values: alert, message, all

timestampFormat

Timestamp format to use for output, 'ISO_8601' or 'MW'. 'MW' is deprecated here, so all clients should switch to 'ISO_8601'. This parameter will be removed, and 'ISO_8601' will become the only output format.

One of the following values: ISO_8601, MW

Default: MW

Example:

Mark notifications of all types as seen

api.php?action=echomarkseen&type=all [open in sandbox]