Skip to content
Announcement:We are updating the criteria to be granted extended access to the Web API.
Please note that starting May 15, 2025 we’re introducing some changes to the way we provide Web API extended quota mode access. For more information, read here.
Web API •References / Player / Toggle Playback Shuffle

Toggle Playback Shuffle

Toggle shuffle on or off for user’s playback. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.

Authorization scopes

Request

  • state
    boolean
    Required

    true : Shuffle user's playback.
    false : Do not shuffle user's playback.

    Example: state=true
  • device_id
    string

    The id of the device this command is targeting. If not supplied, the user's currently active device is the target.

    Example: device_id=0d1841b0976bae2a3a310dd74c0f3df354899bc8

Response

Command sent

endpointhttps://api.spotify.com/v1/me/player/shufflestate
device_id

Response sample