Reorder or Replace a Playlist's Items

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.

Responses

🟢200On a successful **reorder** operation, the response body contains a `snapshot_id` in JSON format and the HTTP status code in the response header is `200` OK. The `snapshot_id` can be used to identify your playlist version in future requests. On a success

application/json

Body

🟢201On a successful **reorder** operation, the response body contains a `snapshot_id` in JSON format and the HTTP status code in the response header is `200` OK. The `snapshot_id` can be used to identify your playlist version in future requests. On a success

🔴500500

curl --location --request PUT 'https://api.spotify.com/v1/playlists//tracks' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "insert_before": 0, "range_length": 0, "range_start": 0, "snapshot_id": "string", "uris": [ "string" ] }'

Reorder or Replace a Playlist's Items

Request

Responses