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.


PUT http://{ip_address}:32400/playlists/{id}?{fields}&X-Plex-Token={plex_token}


ip_addressThe IP address of the Plex Media server.
plex_tokenThe Plex user token.
idThe 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.
fieldsA list of fields and their values that will be updated for the playlist. See the Remarks section below.

Return Status

HTTP CodeDescription
200Success - The request was successful.
400Bad request - A parameter is missing.
401Unauthorized - The Plex token provided is not valid.
404Not Found - The playlist associated with the ID was not found.


No response is returned by the command. The status code will indicate whether the playlist was updated successfully.



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:

Field names for a playlist.
titleThe title of the playlist.
summaryA descriptive summary of the playlist.

An example of updating the title of a playlist:'s Movies&X-Plex-Token=1ygdVs1p96ufz_FwzGrg

You can update multiple fields as follows:'s Movies&summary=Movies released in the 1990 decade.&X-Plex-Token=1ygdVs1p96ufz_FwzGrg


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)
$response = Invoke-RestMethod 'http://{ip_address}:32400/playlists/{id}?{fields}&X-Plex-Token={plex_token}' -Method 'PUT'
Write-Output $response