These endpoints are in Beta. While we encourage you to build with them, a situation may arise where we need to disable some or all of the functionality and/or change how they work without prior notice. Please report any issues via our GitHub issue tracker.



Request Parameters

Header Fields

Header Field Value
Authorization Required. A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details.
The access token must have been issued on behalf of a user.
The access token must have the user-modify-playback-state scope authorized in order to control playback.

Query Parameters

Query Parameter Value
state Required.
track, context or off.
track will repeat the current track.
context will repeat the current context.
off will turn repeat off.
device_id Optional. The id of the device this command is targeting. If not supplied, the user’s currently active device is the target.

Response Format

A successful request will return a 204 NO CONTENT response code. When the device is temporarily unavailable the request will return a 202 ACCEPTED response code and the client should retry the request after 5 seconds, but no more than at most 5 retries. If the device is not found, the request will return 404 NOT FOUND response code. If the user making the request is non-premium, a 403 FORBIDDEN response code will be returned.


curl -X PUT "" -H "Authorization: Bearer {your access token}"

Try it