Start/Resume a User's Playback

Developing

PUT

/me/player/play

Start a new context or resume current playback on the user's active device.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.spotify.com/v1/me/player/play' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "context_uri": "string",
    "offset": {},
    "position_ms": 0,
    "uris": [
        "string"
    ]
}'

Response Example

200 - Example 1

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

Request

Query Params

device_id

string

optional

The id of the device this command is targeting. If not supplied, the user's currently active device is the target.

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

context_uri

string

optional

Spotify URI of the context to play. Valid contexts are albums, artists, playlists. Example: {"context_uri": "spotify:album:1Je1IMUlBXcx1Fz0WE7oPT"}

offset

object

optional

Indicates from where in the context playback should start. Only available when context_uri corresponds to an album or playlist object, or when the uris parameter is used. “position” is zero based and can’t be negative. Example: "offset": {"position": 5} “uri” is a string representing the uri of the item to start at. Example: "offset": {"uri": "spotify:track:1301WleyT98MSxVHPZCA6M"}

position_ms

integer <int32>

optional

Indicates from what position to start playback. Must be a positive number. Passing in a position that is greater than the length of the track will cause the player to start playing the next song.

uris

array[string]

optional

A JSON array of the Spotify track URIs to play. For example: {"uris": ["spotify:track:4iV5W9uYEdYUVa79Axb7Rh", "spotify:track:1301WleyT98MSxVHPZCA6M"]}

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

Pause a User's Playback

Skip User’s Playback To Previous Track