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

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.
This access token must be tied to the user who owns the playlist, and must have the scope ugc-image-upload granted. In addition, the token must also contain playlist-modify-public and/or playlist-modify-private, depending the public status of the playlist you want to update . See Using Scopes.
Content-Type _Required The content type of the request body: image/jpeg

Body Parameters

Base64 encoded JPEG image data, maximum payload size is 256 KB

Rate limiting

If you get status code 429, it means that you have sent too many requests. If this happens, have a look in the Retry-After header, where you will see a number displayed. This is the amount of seconds that you need to wait, before you can retry sending your requests.


A successful request will return a 202 ACCEPTED response code. When the image has been provided, we forward it on to our transcoder service in order to generate the three sizes provided in the playlist’s images object. This operation may take a short time, so performing a GET request to the playlist may not immediately return URLs to the updated images.
On error, the header status code is an error code and the response body contains an error object.