---
title: "Toggle Playback Shuffle"
method: PUT
path: "/me/player/shuffle"
tags: ["Player"]
---

# Toggle Playback Shuffle

`PUT /me/player/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.

## Query parameters

- `state` boolean, required — **true** : Shuffle user's playback.<br/> **false** : Do not shuffle user's playback.
- `device_id` string — The id of the device this command is targeting. If not supplied, the user's currently active device is the target.

## Response `204`

Command sent

## Other responses

- `401` — 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.
- `403` — Bad OAuth request (wrong consumer key, bad nonce, expired timestamp...). Unfortunately, re-authenticating the user won't help here.
- `429` — The app has exceeded its rate limits.

---

[API](https://skmtc.dev/spotify/apis/spotify-web-api.md) · [All operations](https://skmtc.dev/spotify/apis/spotify-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spotify/spotify-web-api/revisions/2d888d731358/schema)