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.


GET http://{ip_address}:32400/:/unscrobble?identifier=com.plexapp.plugins.library&key={key}&X-Plex-Token={plex_token}


ip_addressThe IP address of the Plex Media server.
plex_tokenThe Plex token.
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.


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


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.


curl -X GET http://{ip_address}:32400/:/unscrobble?identifier=com.plexapp.plugins.library&key={key}&X-Plex-Token={plex_token}
import requests
plex_url = http://{ip_address}:32400/:/unscrobble?identifier=com.plexapp.plugins.library&key={key}&X-Plex-Token={plex_token}
response = requests.get(plex_url)
$response = Invoke-RestMethod 'http://{ip_address}:32400/:/unscrobble?identifier=com.plexapp.plugins.library&key={key}&X-Plex-Token={plex_token}' -Method 'GET'
Write-Output $response