Search + K

Command Palette

Search for a command to run...

Sign In

Update Playlist Items

PUT /playlists/{playlist_id}/tracks
Copy endpoint
https://api.spotify.com/v1

Either reorder or replace items in a playlist depending on the request's parameters. To reorder items, include range_start, insert_before, range_length and snapshot_id in the request's body. To replace items, include uris as either a query parameter or in the request's body. Replacing items in a playlist will overwrite its existing items. This operation can be used for replacing or clearing items in a playlist. Note: Replace and reorder are mutually exclusive operations which share the same endpoint, but have different parameters. These operations can't be applied together in a single request.

Parameters

path Path Parameters

Name Type
playlist_id required
string

query Query Parameters

Name Type
uris
string

Request Body

application/json
{
uris?: string[];
range_start?: number;
insert_before?: number;
range_length?: number;
snapshot_id?: string;
[key: string]: unknown;
}

Responses

200 application/json

A snapshot ID for the playlist

{ snapshot_id?: string; }

Client Errors

401 application/json

Bad or expired token. This can happen if the user revoked a token or the access token has expired. You should re-authenticate the user.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }
403 application/json

Bad OAuth request (wrong consumer key, bad nonce, expired timestamp...). Unfortunately, re-authenticating the user won't help here.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }
429 application/json

The app has exceeded its rate limits.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }