Get Update Status
This API command will return the status of the currently available update for the Plex server.
URL
GET http://{ip_address}:32400/updater/status?X-Plex-Token={plex_token}Parameters
| Name | Description |
|---|---|
| ip_address | The IP address of the Plex Media server. |
| plex_token | The Plex token. |
Return Status
| HTTP Code | Description |
|---|---|
| 200 | Success - The request was successful. |
| 401 | Unauthorized - The Plex token provided was not valid. |
| 404 | Not Found - The incorrect method was used in the request. |
Response
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="https://plex.tv/downloads/latest/5?channel=16&build=windows-x86_64&distro=windows&X-Plex-Token=xxxxxxxxxxxxxxxxxxxx" status="0">
<Release key="https://plex.tv/updater/releases/5241" version="1.40.1.8227-c0dd5a73e" 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="https://plex.tv/downloads/latest/5?channel=16&build=windows-x86_64&distro=windows&X-Plex-Token=xxxxxxxxxxxxxxxxxxxx" state="downloaded" />
</MediaContainer>The XML returned status of the update for the server. The root element is MediaContainer and has some information about the current update.
| Attribute | Description |
|---|---|
| size | The number of updates. |
| autoUpdateVersion | Indicates the version of the auto-updater. |
| canInstall | Flag indicating the update can be installed. |
| checkedAt | The date and time in epoch time, when an update was last checked. |
| downloadURL | The URL to the update. |
| status | The status of the update. |
Information about the update is provided in the Release element.
| Attribute | Description |
|---|---|
| key | The unique URL for the release. |
| version | The version of the release. |
| added | A list of features that were added in the release. |
| fixed | A list of features that were fixed in the release. |
| downloadURL | The URL to the release download. |
| state | Indicates the state of the release, such as if the release has been downloaded to the server. |
Remarks
The Plex Media Server update file can be found in the Updates folder in the Plex data directory.
Examples
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)
print(response.text)
$response = Invoke-RestMethod 'http://{ip_address}:32400/updater/status?X-Plex-Token={plex_token}' -Method GET
Write-Output $response