seek

post

{protocol}://api.ws.sonos.com/control/api/{version}/groups/{groupId}/playback/seek

Use the seek command in the playback namespace to go to a specific position in the current track. Optionally add the cloud queue itemId to target a specific track.

Use itemId to ensure the group seeks on the current item. If the current item’s itemId does not match the one provided, the player returns an ERROR_INVALID_OBJECT_ID error.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

{
"positionMillis" : 30000,
"itemId" : "123"
}

When omitting the optional itemId.

{
"positionMillis" : 30000
}

{
"positionMillis" : 30000,
"itemId" : "123"
}

When omitting the optional itemId.

{
"positionMillis" : 30000
}

401

A client has not provided authorization credentials to perform a command

403

A client does not have the correct permissions to perform a command

{
"positionMillis" : 30000,
"itemId" : "123"
}

When omitting the optional itemId.

{
"positionMillis" : 30000
}

{
"positionMillis" : 30000,
"itemId" : "123"
}

When omitting the optional itemId.

{
"positionMillis" : 30000
}

500

Sonos has experience an unexpected condition it is unable to recover from

503

Player is unable to reach the service.

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success Code: 200 OK Content Examples: When including the optional itemId. JavaScript

400Success Code: 200 OK Content Examples: When including the optional itemId. JavaScript

404Success Code: 200 OK Content Examples: When including the optional itemId. JavaScript

499Success Code: 200 OK Content Examples: When including the optional itemId. JavaScript