Get Update Status

This API command will return the status of the currently available update for the Plex server.


GET http://{ip_address}:32400/updater/status?X-Plex-Token={plex_token}


ip_addressThe IP address of the Plex Media server.
plex_tokenThe Plex token.

Return Status

HTTP CodeDescription
200Success - The request was successful.
401Unauthorized - The Plex token provided was not valid.
404Not Found - The incorrect method was used in the request.


XML string value that lists the update status of the server. An example of the XML returned from the request is shown below:

<?xml version="1.0" encoding="UTF-8"?>
<MediaContainer size="1" autoUpdateVersion="1" canInstall="1" checkedAt="1710599790" downloadURL="" status="0">
    <Release key="" version="" added="(Extras) New preference for Cinema Trailers to always include English language trailers when account audio language is not set to English (PM-620).
(Web) Updated to 4.125.1" fixed="(DVR) Replace Lower Quality was not taking effect (#14646)
(Metadata) Marking a show or season as watched created view history entries (PM-935)
(Stream Selection) A show's subtitle mode would not override the account's if account's was set to "Manually selected" (PM-660)
(View History) Keep view history of items when marked as unplayed (#14663)
(View History) View history was not created when a partially played item was marked as played (PM-1021)
(Web) Home Screen content would not load when unauthenticated. (DISCO-1547)
(Web) Refreshing the browser during playback would cause an error in the playback session. (DISCO-1612)" downloadURL="" state="downloaded" />

The XML returned status of the update for the server. The root element is MediaContainer and has some information about the current update.

MediaContainer Attributes
sizeThe number of updates.
autoUpdateVersionIndicates the version of the auto-updater.
canInstallFlag indicating the update can be installed.
checkedAtThe date and time in epoch time, when an update was last checked.
downloadURLThe URL to the update.
statusThe status of the update.

Information about the update is provided in the Release element.

Release Attributes
keyThe unique URL for the release.
versionThe version of the release.
addedA list of features that were added in the release.
fixedA list of features that were fixed in the release.
downloadURLThe URL to the release download.
stateIndicates the state of the release, such as if the release has been downloaded to the server.


The Plex Media Server update file can be found in the Updates folder in the Plex data directory.


curl -X GET http://{ip_address}:32400/updater/status?X-Plex-Token={plex_token}
import requests
plex_url = http://{ip_address}:32400/updater/status?X-Plex-Token={plex_token}
response = requests.get(plex_url)
$response = Invoke-RestMethod 'http://{ip_address}:32400/updater/status?X-Plex-Token={plex_token}' -Method 'GET'
Write-Output $response