v1

latestOpenAPI 3.0.32026-07-139687282.9 KB

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 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