Sign in

v1

latestOpenAPI 3.0.32026-07-148993228.8 KB
Player

Start/Resume Playback

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

put/me/player/play

Query parameters

device_idstring

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

Example:0d1841b0976bae2a3a310dd74c0f3df354899bc8

Request body

context_uristring

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

offsetobject

Optional. Indicates from where in the context playback should start. Only available when context_uri corresponds to an album or playlist object "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_msinteger

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.

urisstring[]

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

Example request

{
  "context_uri": "spotify:album:5ht7ItJgpBH7W6vJ5BqpPr",
  "offset": {
    "position": 5
  },
  "position_ms": 0
}

Response

Playback started