Update a Playlist
Each user on a Plex server can create their own playlists. A playlist can contain either videos, music, or photos, and can't be shared with other users. There are smart and non-smart playlists. This API command will update a playlist for a user.
URL
PUT http://{ip_address}:32400/playlists/{id}?{fields}&X-Plex-Token={plex_token}Parameters
| Name | Description |
|---|---|
| ip_address | The IP address of the Plex Media server. |
| plex_token | The Plex user token. |
| id | The ID associated with the playlist. You can get the ID by calling the Get All Playlists API command and using the value in the ratingKey attribute. |
| fields | A list of fields and their values that will be updated for the playlist. See the Remarks section below. |
Return Status
| HTTP Code | Description |
|---|---|
| 200 | Success - The request was successful. |
| 400 | Bad request - A parameter is missing. |
| 401 | Unauthorized - The Plex token provided is not valid. |
| 404 | Not Found - The playlist associated with the ID was not found. |
Response
No response is returned by the command. The status code will indicate whether the playlist was updated successfully.
Remarks
Fields
When updating a playlist the fields and their new value will need to be specified in the request. The valid field values are listed in the following table:
| Name | Description |
|---|---|
| title | The title of the playlist. |
| summary | A descriptive summary of the playlist. |
An example of updating the title of a playlist:
http://192.168.1.10:32400/playlists/279055?title=1990's Movies&X-Plex-Token=1ygdVs1p96ufz_FwzGrg
You can update multiple fields as follows:
http://192.168.1.10:32400/playlists/279055?title=1990's Movies&summary=Movies released in the 1990 decade.&X-Plex-Token=1ygdVs1p96ufz_FwzGrg
Examples
curl -X PUT http://{ip_address}:32400/playlists/{id}?{fields}&X-Plex-Token={plex_token}
import requests
plex_url = http://{ip_address}:32400/playlists/{id}?{fields}&X-Plex-Token={plex_token}
response = requests.put(plex_url)
print(response.text)
$response = Invoke-RestMethod 'http://{ip_address}:32400/playlists/{id}?{fields}&X-Plex-Token={plex_token}' -Method 'PUT'
Write-Output $response