Endpoint

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

Request Parameters

Path Parameters

Path Parameter Value
user_id The user’s Spotify user ID.
playlist_id The Spotify ID for the playlist.

Header Fields

Header Field Value
Authorization Required. 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-Type Required. The content type of the request body: application/json

Body Parameters

Request Body Data Value Type Value
name string Optional. The new name for the playlist, for example "My New Playlist Title".
public Boolean Optional. If true the playlist will be public, if false it will be private.
collaborative Boolean Optional. If true , the playlist will become collaborative and other users will be able to modify the playlist in their Spotify client. Note: You can only set collaborative to true on non-public playlists.
description string Optional. Value for playlist description as displayed in Spotify Clients and in the Web API.

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