Player

Transfer Playback

Transfer playback to a new device and optionally begin 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.

put/me/player

Request

  • Base URL
    https://api.spotify.com/v1
  • URL
    https://api.spotify.com/v1/me/player
  • Auth
    OAuth 2
    Authorization code: https://accounts.spotify.com/authorize
    Token URL: https://accounts.spotify.com/api/token scopes: user-modify-playback-state

Request body

device_idsstring[] required

A JSON array containing the ID of the device on which playback should be started/transferred.<br/>For example:{device_ids:["74ASZWbe4lXaubB36ztrGX"]}<br/>Note: Although an array is accepted, only a single device_id is currently supported. Supplying more than one will return 400 Bad Request

playboolean

true: ensure playback happens on new device.<br/>false or not provided: keep the current playback state.

Example request

{
  "device_ids": [
    "74ASZWbe4lXaubB36ztrGX"
  ]
}

Response

Playback transferred

Changes

No recorded changes to this operation across all 7 revisions of this API.