API:SetNotificationTimestamp

Language:	English  • 日本語

This page is part of the MediaWiki action API documentation.

MediaWiki APIsAPI:Main page

• Web APIs showcaseAPI:Web APIs hub
• REST content API

MediaWiki action API

• Introduction and quick startAPI:Main page
• FAQAPI:FAQ
  • Etiquette and usage limitsAPI:Etiquette
• TutorialAPI:Tutorial
• FormatsAPI:Data formats
• Error reportingAPI:Errors and warnings
• Restricting usageAPI:Restricting API usage
• Cross-site requestsAPI:Cross-site requests
• Authentication
  • LoginAPI:Login
  • LogoutAPI:Logout
  • Account creationAPI:Account creation
• QueriesAPI:Query
  • Meta informationAPI:Meta
  • PropertiesAPI:Properties
  • ListsAPI:Lists
• Searching (by title, content, coordinates...)API:Search and discovery
• Parsing wikitext and expanding templatesAPI:Parsing wikitext
• Purging pages' cachesAPI:Purge
• Parameter informationAPI:Parameter information
• Changing wiki contentAPI:Changing wiki content
  • Create and edit pagesAPI:Edit
  • Move pagesAPI:Move
  • RollbackAPI:Rollback
  • Delete pagesAPI:Delete
  • Restore deleted revisionsAPI:Undelete
  • (Un)protect pagesAPI:Protect
  • (Un)block usersAPI:Block
  • (Un)watch pagesAPI:Watch
  • Mark revisions of watched pages as visitedAPI:SetNotificationTimestamp
  • Send emailAPI:Email
  • Patrol changesAPI:Patrol
  • Import pagesAPI:Import
  • Change user group membershipAPI:User group membership
  • Upload filesAPI:Upload
  • User optionsAPI:Options
  • TokensAPI:Tokens
  • Page languageAPI:PageLanguage
• Watchlist feedAPI:Watchlist feed
• WikidataWikibase/API
• ExtensionsAPI:Extensions
• Using the API in MediaWiki and extensionsAPI:Calling internally
• MiscellaneousAPI:Other services
• ImplementationAPI:Implementation Strategy
  • LocalisationAPI:Localisation
• Client codeAPI:Client code
• AssertingAPI:Assert

setnotificationtimestamp
Prefix	none
Required rights	none
Post only?	Yes
Generated help	Current
Version added	≥ 1.14

This module is used to mark revisions of watched pages as visited. This affects the highlighting of changed pages in the watchlist and history, and the sending of email when the "Email me when a page on my watchlist is changed" preference is enabled.

This module requires POST requests; GET requests will not work.

Token

Users of this module must be correctly logged in, as a valid edit token is required. For example:

Obtaining an edit token

api.php?action=query&prop=info&intoken=edit&titles=Main_Page [try in ApiSandbox]

Parameters

• entirewatchlist: Work on all watched pages.
• token: Edit token retrieved in previous step (required).
• timestamp: Timestamp to which to set the notification timestamp.
• torevid: Revision to set the notification timestamp to (one page only).
• newerthanrevid: Revision to set the notification timestamp newer than (one page only).
• titles: A list of titles to work on. Standard rules and limits apply. (See API:Query#Specifying pages.)
• pageids: A list of page IDs to work on. Standard rules and limits apply.
• revids: A list of revision IDs to work on. Standard rules and limits apply.
• redirects: Automatically resolve redirects.
• converttitles: Convert titles to other variants if necessary. Only works if the wiki's content language supports variant conversion. Languages that support variant conversion include gan, iu, kk, ku, shi, sr, tg, uz, zh.
• generator: Get the list of pages to work on using a generator. (See API:Query#Generators.)

Examples

Marking entire watchlist as visited

api.php?action=setnotificationtimestamp&entirewatchlist=&token=1ccc023d58931de3acc6c39c7af2e420+\ [try in ApiSandbox]

Marking all edits to "Wikipedia talk:Sandbox" since 1 January 2012 as unviewed

api.php?action=setnotificationtimestamp&titles=Wikipedia:Sandbox&timestamp=2012-01-01T00:00:00Z&token=1ccc023d58931de3acc6c39c7af2e420+\ [try in ApiSandbox]