Mark Item as Unwatched

All media items in Plex are marked as either being unwatched or watched. New items will automatically be marked as unwatched.

This API command will mark a specified media item as unwatched.

URL

GET http://[IP address]:32400/:/unscrobble?identifier=com.plexapp.plugins.library&key=[Media Key]&X-Plex-Token=[PlexToken]

Parameters

NameDescription
IP addressThe IP address of the Plex Media server.
PlexTokenThe temporary authentication Plex token.
Media KeyThe unique key for the media item to be marked as watched. Information about getting this key can be found below in the Media Key section.

Return Status

HTTP CodeDescription
200Success - The request was successful.
401Unauthorized - The Plex token provided was not valid.

Response

No response is returned. You will be able to see the clean bundles API command run from the Plex console.

Remarks

Media Key

The media key can be found using other API commands. For movies and videos, use the Get All Movies API command. From this API command get the integer value from the end of the key attribute of the Video element.

To mark entire TV shows, for all seasons and episodes, call the Get All TV Shows command and use the ratingKey attribute value from the Directory element.

For TV shows episodes, call the Get All TV Show Episodes command the use the integer value from the end of the key attribute of the Video element.

To mark a music track as unplayed, call the Get All Tracks for a Music Album command and use the ratingKey value from the Track element.

Examples

curl -X GET http://[IP address]:32400/:/unscrobble?identifier=com.plexapp.plugins.library&key=[Media Key]&X-Plex-Token=[PlexToken]
import requests
plex_url = http://[IP address]:32400/:/unscrobble?identifier=com.plexapp.plugins.library&key=[Media Key]&X-Plex-Token=[PlexToken]
response = requests.get(plex_url)
print(response.text)
$response = Invoke-RestMethod 'http://[IP address]:32400/:/unscrobble?identifier=com.plexapp.plugins.library&key=[Media Key]&X-Plex-Token=[PlexToken]' -Method 'GET'
Write-Output $response
Subscribe
Display