Spotify Web API

Transfer a User's Playback

Developing

PUT

/me/player

category-player

Transfer playback to a new device and determine if it should start playing.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.spotify.com/v1/me/player' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw ''

Response Example

200 - Example 1

{
  "error": {
    "message": "string",
    "status": 0
  }
}

Request

Header Params

Authorization

string

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.

Body Params application/json

device_ids

array[string]

required

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

play

boolean

optional

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

Examples

Responses

🟢200OK

application/json

Body

error

object (ErrorObject)

optional

message

string

optional

A short description of the cause of the error.

status

integer <int32>

optional

The HTTP status code (also returned in the response header; see Response Status Codes for more information).

🟢204A completed request will return a `204 NO CONTENT` response code, and then issue the command to the player. Due to the asynchronous nature of the issuance of the command, you should use the [Get Information About The User's Current Playback](https://devel

Modified at 2022-09-12 10:04:50

Get Information About The User's Current Playback

Get the User's Currently Playing Track