Change a playlist’s name and public/private state. (The user must, of course, own the playlist.)

Endpoint

PUT https://api.spotify.com/v1/users/{user_id}/playlists/{playlist_id}

Request Parameters

Path parameter
Value
user_id
The user's Spotify user ID.
playlist_id
The Spotify ID for the playlist.

Header field
Value
AuthorizationRequired. A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The access token must have been issued on behalf of the user.

Changing a public playlist for a user requires authorization of the playlist-modify-public scope; changing a private playlist requires the playlist-modify-private scope. See Using Scopes.

Content-TypeRequired. The content type of the request body: application/json

Request dataValue typeValue
namestringOptional. The new name for the playlist, for example "My New Playlist Title".
publicBooleanOptional. If true the playlist will be public, if false it will be private.

Note that the request data is a JSON string, not separate fields (see the example request, below).

Response Format

On success the HTTP status code in the response header is 200 OK.

On error, the header status code is an error code and the response body contains an error object. Trying to change a playlist when you do not have the user’s authorization returns error 403 Forbidden.

Example

Note that cURL requires quotation marks within the JSON data to be escaped, for example. \"name\":\"A name\".
curl -i -X PUT "https://api.spotify.com/v1/users/wizzler/playlists/6Df19VKaShrdWrAnHinwVO" -H "Authorization: Bearer {your access token}" -H "Content-Type: application/json" --data "{\"name\":\"My New Playlist Title\", \"public\": true}"
HTTP/1.1 200 OK

Try it in our Web API Console