Skip to content
DocumentationAPI Reference

Remove Playlist Items

TrackRemoveResponse playlists().tracks().remove(TrackRemoveParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
DELETE/playlists/{playlist_id}/tracks

Remove one or more items from a user's playlist.

ParametersExpand Collapse
TrackRemoveParams params
Optional<String> playlistId

The Spotify ID of the playlist.

List<Track> tracks

An array of objects containing Spotify URIs of the tracks or episodes to remove. For example: { "tracks": [{ "uri": "spotify:track:4iV5W9uYEdYUVa79Axb7Rh" },{ "uri": "spotify:track:1301WleyT98MSxVHPZCA6M" }] }. A maximum of 100 objects can be sent at once.

Optional<String> uri

Spotify URI

Optional<Boolean> published

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

Optional<String> snapshotId

The playlist's snapshot ID against which you want to make the changes. The API will validate that the specified items exist and in the specified positions and make the changes, even if more recent changes have been made to the playlist.

ReturnsExpand Collapse
class TrackRemoveResponse:
Optional<String> snapshotId

Remove Playlist Items

package dev.cjav.spotted.example;

import dev.cjav.spotted.client.SpottedClient;
import dev.cjav.spotted.client.okhttp.SpottedOkHttpClient;
import dev.cjav.spotted.models.playlists.tracks.TrackRemoveParams;
import dev.cjav.spotted.models.playlists.tracks.TrackRemoveResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        SpottedClient client = SpottedOkHttpClient.fromEnv();

        TrackRemoveParams params = TrackRemoveParams.builder()
            .playlistId("3cEYpjA9oz9GiPac4AsH4n")
            .addTrack(TrackRemoveParams.Track.builder().build())
            .build();
        TrackRemoveResponse track = client.playlists().tracks().remove(params);
    }
}
{
  "snapshot_id": "abc"
}
Returns Examples
{
  "snapshot_id": "abc"
}