Notifications/API

From mediawiki.org
Jump to navigation Jump to search

meta=notifications (not)

(main | query | notifications)
  • This module requires read rights.
  • Source: Echo
  • License: MIT

Get notifications waiting for the current user.

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, altwiki, amwiki, amwikimedia, amwikiquote, amwiktionary, angwiki, angwikibooks, angwikiquote, angwikisource, angwiktionary, anwiki, anwiktionary, apiportalwiki, arbcom_cswiki, arbcom_dewiki, arbcom_enwiki, arbcom_fiwiki, arbcom_nlwiki, arbcom_ruwiki, arcwiki, arwiki, arwikibooks, arwikimedia, arwikinews, arwikiquote, arwikisource, arwikiversity, arwiktionary, arywiki, arzwiki, astwiki, astwikibooks, astwikiquote, astwiktionary, aswiki, aswikibooks, aswikisource, aswiktionary, atjwiki, auditcomwiki, avkwiki, avwiki, avwiktionary, awawiki, aywiki, aywikibooks, aywiktionary, azbwiki, azwiki, azwikibooks, azwikiquote, azwikisource, azwiktionary, banwiki, barwiki, bat_smgwiki, bawiki, bawikibooks, bclwiki, bclwiktionary, 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, diqwiktionary, 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, eowikivoyage, 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, 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, gcrwiki, gdwiki, gdwiktionary, gewikimedia, glkwiki, glwiki, glwikibooks, glwikiquote, glwikisource, glwiktionary, gnwiki, gnwikibooks, gnwiktionary, gomwiki, gomwiktionary, gorwiki, gotwiki, gotwikibooks, grantswiki, grwikimedia, guwiki, guwikibooks, guwikiquote, guwikisource, guwiktionary, gvwiki, gvwiktionary, hakwiki, hawiki, hawiktionary, hawwiki, hewiki, hewikibooks, hewikinews, hewikiquote, hewikisource, hewikivoyage, hewiktionary, hifwiki, hifwiktionary, hiwiki, hiwikibooks, hiwikimedia, hiwikiquote, hiwikisource, 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, jawikivoyage, 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, lijwikisource, liwiki, liwikibooks, liwikinews, liwikiquote, liwikisource, liwiktionary, lldwiki, lmowiki, lnwiki, lnwikibooks, lnwiktionary, loginwiki, lowiki, lowiktionary, lrcwiki, ltgwiki, ltwiki, ltwikibooks, ltwikiquote, ltwikisource, ltwiktionary, lvwiki, lvwikibooks, lvwiktionary, madwiki, maiwiki, maiwikimedia, map_bmswiki, mdfwiki, mediawikiwiki, metawiki, mgwiki, mgwikibooks, mgwiktionary, mhrwiki, mhwiki, mhwiktionary, minwiki, minwiktionary, miwiki, miwikibooks, miwiktionary, mkwiki, mkwikibooks, mkwikimedia, mkwikisource, mkwiktionary, mlwiki, mlwikibooks, mlwikiquote, mlwikisource, mlwiktionary, mniwiki, mniwiktionary, mnwiki, mnwikibooks, mnwiktionary, mnwwiki, mnwwiktionary, 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, ngwikimedia, niawiki, niawiktionary, nlwiki, nlwikibooks, nlwikimedia, nlwikinews, nlwikiquote, nlwikisource, nlwikivoyage, nlwiktionary, nnwiki, nnwikiquote, nnwiktionary, noboard_chapterswikimedia, nostalgiawiki, novwiki, nowiki, nowikibooks, nowikimedia, nowikinews, nowikiquote, nowikisource, nowiktionary, nqowiki, 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, shnwiktionary, shwiki, shwiktionary, shywiktionary, simplewiki, simplewikibooks, simplewikiquote, simplewiktionary, siwiki, siwikibooks, siwiktionary, skrwiki, skrwiktionary, skwiki, skwikibooks, skwikiquote, skwikisource, skwiktionary, slwiki, slwikibooks, slwikiquote, slwikisource, slwikiversity, slwiktionary, smnwiki, 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, sysop_itwiki, szlwiki, szywiki, tawiki, tawikibooks, tawikinews, tawikiquote, tawikisource, tawiktionary, taywiki, tcywiki, techconductwiki, tenwiki, test2wiki, testcommonswiki, testwiki, testwikidatawiki, tetwiki, tewiki, tewikibooks, tewikiquote, tewikisource, tewiktionary, tgwiki, tgwikibooks, tgwiktionary, thankyouwiki, thwiki, thwikibooks, thwikinews, thwikiquote, thwikisource, thwiktionary, tiwiki, tiwiktionary, tkwiki, tkwikibooks, tkwikiquote, tkwiktionary, tlwiki, tlwikibooks, tlwiktionary, tnwiki, tnwiktionary, towiki, towiktionary, tpiwiki, tpiwiktionary, transitionteamwiki, trvwiki, trwiki, trwikibooks, trwikimedia, trwikinews, trwikiquote, trwikisource, trwikivoyage, 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, wawikisource, 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 clients allowed higher limits).
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): count, list, 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: flyout, html, model, special
notlimit

The maximum number of notifications to return.

Type: integer or max
The value must be between 1 and 50.
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 clients allowed higher limits).
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[edit]

api.php?action=query&meta=notifications [try in ApiSandbox]
Result
{
    "query": {
        "notifications": {
            "list": {
                "32073090": {
                    "id": "32073090",
                    "type": "edit-user-talk",
                    "category": "edit-user-talk",
                    "timestamp": {
                        "utcunix": "1407588715",
                        "unix": "1407588715",
                        "mw": "20140809125155",
                        "date": "Yesterday"
                    },
                    "title": {
                        "full": "User talk:Legoktm",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Legoktm"
                    },
                    "agent": {
                        "id": "20181147",
                        "name": "MediaWiki message delivery"
                    },
                    "read": "20140809133142"
                },
                "32019731": {
                    "id": "32019731",
                    "type": "mention",
                    "category": "mention",
                    "timestamp": {
                        "utcunix": "1407515727",
                        "unix": "1407515727",
                        "mw": "20140808163527",
                        "date": "8 August"
                    },
                    "title": {
                        "full": "User talk:Legobot",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Legobot"
                    },
                    "agent": {
                        "id": "17844196",
                        "name": "Dogmaticeclectic"
                    },
                    "read": "20140808230020"
                },
                "32009818": {
                    "id": "32009818",
                    "type": "mention",
                    "category": "mention",
                    "timestamp": {
                        "utcunix": "1407505532",
                        "unix": "1407505532",
                        "mw": "20140808134532",
                        "date": "8 August"
                    },
                    "title": {
                        "full": "MediaWiki talk:Gadgets-definition",
                        "namespace": "MediaWiki_talk",
                        "namespace-key": 9,
                        "text": "Gadgets-definition"
                    },
                    "agent": {
                        "id": "5559148",
                        "name": "Helder.wiki"
                    },
                    "read": "20140808140632"
                },
                "31998545": {
                    "id": "31998545",
                    "type": "mention",
                    "category": "mention",
                    "timestamp": {
                        "utcunix": "1407491422",
                        "unix": "1407491422",
                        "mw": "20140808095022",
                        "date": "8 August"
                    },
                    "title": {
                        "full": "User talk:Jasper Deng",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Jasper Deng"
                    },
                    "agent": {
                        "id": "7030996",
                        "name": "Jasper Deng"
                    },
                    "read": "20140808140632"
                },
                "31992022": {
                    "id": "31992022",
                    "type": "edit-user-talk",
                    "category": "edit-user-talk",
                    "timestamp": {
                        "utcunix": "1407481624",
                        "unix": "1407481624",
                        "mw": "20140808070704",
                        "date": "8 August"
                    },
                    "title": {
                        "full": "User talk:Legoktm",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Legoktm"
                    },
                    "agent": {
                        "id": "1257855",
                        "name": "Gogo Dodo"
                    },
                    "read": "20140808071336"
                },
                "31971762": {
                    "id": "31971762",
                    "type": "mention",
                    "category": "mention",
                    "timestamp": {
                        "utcunix": "1407450878",
                        "unix": "1407450878",
                        "mw": "20140807223438",
                        "date": "7 August"
                    },
                    "title": {
                        "full": "User talk:Legobot",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Legobot"
                    },
                    "agent": {
                        "id": "9041631",
                        "name": "Sock"
                    },
                    "read": "20140807224103"
                },
                "31955623": {
                    "id": "31955623",
                    "type": "mention",
                    "category": "mention",
                    "timestamp": {
                        "utcunix": "1407433726",
                        "unix": "1407433726",
                        "mw": "20140807174846",
                        "date": "7 August"
                    },
                    "title": {
                        "full": "User talk:Legobot",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Legobot"
                    },
                    "agent": {
                        "id": "17844196",
                        "name": "Dogmaticeclectic"
                    },
                    "read": "20140807210847"
                },
                "31701247": {
                    "id": "31701247",
                    "type": "edit-user-talk",
                    "category": "edit-user-talk",
                    "timestamp": {
                        "utcunix": "1407137848",
                        "unix": "1407137848",
                        "mw": "20140804073728",
                        "date": "4 August"
                    },
                    "title": {
                        "full": "User talk:Legoktm",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Legoktm"
                    },
                    "agent": {
                        "id": "20181147",
                        "name": "MediaWiki message delivery"
                    },
                    "read": "20140804183302"
                },
                "31548314": {
                    "id": "31548314",
                    "type": "edit-user-talk",
                    "category": "edit-user-talk",
                    "timestamp": {
                        "utcunix": "1406956004",
                        "unix": "1406956004",
                        "mw": "20140802050644",
                        "date": "2 August"
                    },
                    "title": {
                        "full": "User talk:Legoktm",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Legoktm"
                    },
                    "agent": {
                        "id": "20181147",
                        "name": "MediaWiki message delivery"
                    },
                    "read": "20140802053021"
                },
                "31541129": {
                    "id": "31541129",
                    "type": "edit-thank",
                    "category": "edit-thank",
                    "timestamp": {
                        "utcunix": "1406945928",
                        "unix": "1406945928",
                        "mw": "20140802021848",
                        "date": "2 August"
                    },
                    "title": {
                        "full": "Wikipedia talk:Good article nominations",
                        "namespace": "Wikipedia_talk",
                        "namespace-key": 5,
                        "text": "Good article nominations"
                    },
                    "agent": {
                        "id": "8356162",
                        "name": "Mlpearc"
                    },
                    "read": "20140802023420"
                },
                "31540822": {
                    "id": "31540822",
                    "type": "edit-user-talk",
                    "category": "edit-user-talk",
                    "timestamp": {
                        "utcunix": "1406945520",
                        "unix": "1406945520",
                        "mw": "20140802021200",
                        "date": "2 August"
                    },
                    "title": {
                        "full": "User talk:Legoktm",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Legoktm"
                    },
                    "agent": {
                        "id": "18522464",
                        "name": "Dustin V. S."
                    },
                    "read": "20140802021427"
                },
                "31539456": {
                    "id": "31539456",
                    "type": "edit-user-talk",
                    "category": "edit-user-talk",
                    "timestamp": {
                        "utcunix": "1406943786",
                        "unix": "1406943786",
                        "mw": "20140802014306",
                        "date": "2 August"
                    },
                    "title": {
                        "full": "User talk:Legoktm",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Legoktm"
                    },
                    "agent": {
                        "id": "18522464",
                        "name": "Dustin V. S."
                    },
                    "read": "20140802020616"
                },
                "31512076": {
                    "id": "31512076",
                    "type": "edit-user-talk",
                    "category": "edit-user-talk",
                    "timestamp": {
                        "utcunix": "1406913464",
                        "unix": "1406913464",
                        "mw": "20140801171744",
                        "date": "1 August"
                    },
                    "title": {
                        "full": "User talk:Legoktm",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Legoktm"
                    },
                    "agent": {
                        "id": "18522464",
                        "name": "Dustin V. S."
                    },
                    "read": "20140801180110"
                },
                "31409993": {
                    "id": "31409993",
                    "type": "mention",
                    "category": "mention",
                    "timestamp": {
                        "utcunix": "1406797810",
                        "unix": "1406797810",
                        "mw": "20140731091010",
                        "date": "31 July"
                    },
                    "title": {
                        "full": "User talk:Mosfetfaser",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Mosfetfaser"
                    },
                    "agent": {
                        "id": "20362198",
                        "name": "Mosfetfaser"
                    },
                    "read": "20140731091429"
                },
                "31359647": {
                    "id": "31359647",
                    "type": "mention",
                    "category": "mention",
                    "timestamp": {
                        "utcunix": "1406729356",
                        "unix": "1406729356",
                        "mw": "20140730140916",
                        "date": "30 July"
                    },
                    "title": {
                        "full": "User talk:Legobot",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Legobot"
                    },
                    "agent": {
                        "id": "1795359",
                        "name": "Xeno"
                    },
                    "read": "20140730174718"
                },
                "31348642": {
                    "id": "31348642",
                    "type": "edit-user-talk",
                    "category": "edit-user-talk",
                    "timestamp": {
                        "utcunix": "1406715083",
                        "unix": "1406715083",
                        "mw": "20140730101123",
                        "date": "30 July"
                    },
                    "title": {
                        "full": "User talk:Legoktm",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Legoktm"
                    },
                    "agent": {
                        "id": "13249226",
                        "name": "Petrb"
                    },
                    "read": "20140730174718"
                },
                "31326928": {
                    "id": "31326928",
                    "type": "edit-user-talk",
                    "category": "edit-user-talk",
                    "timestamp": {
                        "utcunix": "1406682712",
                        "unix": "1406682712",
                        "mw": "20140730011152",
                        "date": "30 July"
                    },
                    "title": {
                        "full": "User talk:Legoktm",
                        "namespace": "User_talk",
                        "namespace-key": 3,
                        "text": "Legoktm"
                    },
                    "agent": {
                        "id": "18522464",
                        "name": "Dustin V. S."
                    },
                    "read": "20140730064830"
                },
                "31290304": {
                    "id": "31290304",
                    "type": "reverted",
                    "category": "reverted",
                    "timestamp": {
                        "utcunix": "1406646032",
                        "unix": "1406646032",
                        "mw": "20140729150032",
                        "date": "29 July"
                    },
                    "title": {
                        "full": "User:Alex Smotrov/histcomb.js",
                        "namespace": "User",
                        "namespace-key": 2,
                        "text": "Alex Smotrov/histcomb.js"
                    },
                    "agent": {
                        "id": "5559148",
                        "name": "Helder.wiki"
                    },
                    "read": "20140729151044"
                },
                "31230136": {
                    "id": "31230136",
                    "type": "mention",
                    "category": "mention",
                    "timestamp": {
                        "utcunix": "1406571818",
                        "unix": "1406571818",
                        "mw": "20140728182338",
                        "date": "28 July"
                    },
                    "title": {
                        "full": "MediaWiki talk:Gadget-GoogleTrans.js",
                        "namespace": "MediaWiki_talk",
                        "namespace-key": 9,
                        "text": "Gadget-GoogleTrans.js"
                    },
                    "agent": {
                        "id": "5559148",
                        "name": "Helder.wiki"
                    },
                    "read": "20140728183108"
                },
                "31207779": {
                    "id": "31207779",
                    "type": "mention",
                    "category": "mention",
                    "timestamp": {
                        "utcunix": "1406548835",
                        "unix": "1406548835",
                        "mw": "20140728120035",
                        "date": "28 July"
                    },
                    "title": {
                        "full": "MediaWiki talk:Gadget-GoogleTrans.js",
                        "namespace": "MediaWiki_talk",
                        "namespace-key": 9,
                        "text": "Gadget-GoogleTrans.js"
                    },
                    "agent": {
                        "id": "5559148",
                        "name": "Helder.wiki"
                    },
                    "read": "20140728175345"
                }
            },
            "continue": "1406534965|31196996"
        }
    }
}

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.

Parameters:
wikis

List of wikis to mark notification as read (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, altwiki, amwiki, amwikimedia, amwikiquote, amwiktionary, angwiki, angwikibooks, angwikiquote, angwikisource, angwiktionary, anwiki, anwiktionary, apiportalwiki, arbcom_cswiki, arbcom_dewiki, arbcom_enwiki, arbcom_fiwiki, arbcom_nlwiki, arbcom_ruwiki, arcwiki, arwiki, arwikibooks, arwikimedia, arwikinews, arwikiquote, arwikisource, arwikiversity, arwiktionary, arywiki, arzwiki, astwiki, astwikibooks, astwikiquote, astwiktionary, aswiki, aswikibooks, aswikisource, aswiktionary, atjwiki, auditcomwiki, avkwiki, avwiki, avwiktionary, awawiki, aywiki, aywikibooks, aywiktionary, azbwiki, azwiki, azwikibooks, azwikiquote, azwikisource, azwiktionary, banwiki, barwiki, bat_smgwiki, bawiki, bawikibooks, bclwiki, bclwiktionary, 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, diqwiktionary, 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, eowikivoyage, 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, 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, gcrwiki, gdwiki, gdwiktionary, gewikimedia, glkwiki, glwiki, glwikibooks, glwikiquote, glwikisource, glwiktionary, gnwiki, gnwikibooks, gnwiktionary, gomwiki, gomwiktionary, gorwiki, gotwiki, gotwikibooks, grantswiki, grwikimedia, guwiki, guwikibooks, guwikiquote, guwikisource, guwiktionary, gvwiki, gvwiktionary, hakwiki, hawiki, hawiktionary, hawwiki, hewiki, hewikibooks, hewikinews, hewikiquote, hewikisource, hewikivoyage, hewiktionary, hifwiki, hifwiktionary, hiwiki, hiwikibooks, hiwikimedia, hiwikiquote, hiwikisource, 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, jawikivoyage, 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, lijwikisource, liwiki, liwikibooks, liwikinews, liwikiquote, liwikisource, liwiktionary, lldwiki, lmowiki, lnwiki, lnwikibooks, lnwiktionary, loginwiki, lowiki, lowiktionary, lrcwiki, ltgwiki, ltwiki, ltwikibooks, ltwikiquote, ltwikisource, ltwiktionary, lvwiki, lvwikibooks, lvwiktionary, madwiki, maiwiki, maiwikimedia, map_bmswiki, mdfwiki, mediawikiwiki, metawiki, mgwiki, mgwikibooks, mgwiktionary, mhrwiki, mhwiki, mhwiktionary, minwiki, minwiktionary, miwiki, miwikibooks, miwiktionary, mkwiki, mkwikibooks, mkwikimedia, mkwikisource, mkwiktionary, mlwiki, mlwikibooks, mlwikiquote, mlwikisource, mlwiktionary, mniwiki, mniwiktionary, mnwiki, mnwikibooks, mnwiktionary, mnwwiki, mnwwiktionary, 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, ngwikimedia, niawiki, niawiktionary, nlwiki, nlwikibooks, nlwikimedia, nlwikinews, nlwikiquote, nlwikisource, nlwikivoyage, nlwiktionary, nnwiki, nnwikiquote, nnwiktionary, noboard_chapterswikimedia, nostalgiawiki, novwiki, nowiki, nowikibooks, nowikimedia, nowikinews, nowikiquote, nowikisource, nowiktionary, nqowiki, 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, shnwiktionary, shwiki, shwiktionary, shywiktionary, simplewiki, simplewikibooks, simplewikiquote, simplewiktionary, siwiki, siwikibooks, siwiktionary, skrwiki, skrwiktionary, skwiki, skwikibooks, skwikiquote, skwikisource, skwiktionary, slwiki, slwikibooks, slwikiquote, slwikisource, slwikiversity, slwiktionary, smnwiki, 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, sysop_itwiki, szlwiki, szywiki, tawiki, tawikibooks, tawikinews, tawikiquote, tawikisource, tawiktionary, taywiki, tcywiki, techconductwiki, tenwiki, test2wiki, testcommonswiki, testwiki, testwikidatawiki, tetwiki, tewiki, tewikibooks, tewikiquote, tewikisource, tewiktionary, tgwiki, tgwikibooks, tgwiktionary, thankyouwiki, thwiki, thwikibooks, thwikinews, thwikiquote, thwikisource, thwiktionary, tiwiki, tiwiktionary, tkwiki, tkwikibooks, tkwikiquote, tkwiktionary, tlwiki, tlwikibooks, tlwiktionary, tnwiki, tnwiktionary, towiki, towiktionary, tpiwiki, tpiwiktionary, transitionteamwiki, trvwiki, trwiki, trwikibooks, trwikimedia, trwikinews, trwikiquote, trwikisource, trwikivoyage, 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, wawikisource, 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 clients allowed higher limits).
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 clients allowed higher limits).
unreadlist

A list of notification IDs to mark as unread.

Separate values with | or alternative.
Maximum number of values is 50 (500 for clients allowed higher limits).
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[edit]

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]
Result
{
    "query": {
        "echomarkread": {
            "result": "success",
            "rawcount": 0,
            "count": "0"
        }
    }
}

action=echomarkseen

(main | echomarkseen)
  • This module requires read rights.
  • Source: Echo
  • License: MIT

Mark notifications as seen for the current user.

Parameters:
type

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

This parameter is required.
One of the following values: alert, all, message
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]
Retrieved from "https://www.mediawiki.org/w/index.php?title=Notifications/API&oldid=3910078"