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.

Responses

200

Success Code:

200 OK

Content Examples:

When including the optional itemId.

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

When omitting the optional itemId.

{
"positionMillis" : 30000
}

400

Success Code:

200 OK

Content Examples:

When including the optional itemId.

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

When omitting the optional itemId.

{
"positionMillis" : 30000
}

seek

`200 OK`

Content Examples:

When including the optional `itemId`.

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

When omitting the optional `itemId`.

`{ "positionMillis" : 30000 }`

`200 OK`

Content Examples:

When including the optional `itemId`.

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

When omitting the optional `itemId`.

`{ "positionMillis" : 30000 }`

`200 OK`

Content Examples:

When including the optional `itemId`.

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

When omitting the optional `itemId`.

`{ "positionMillis" : 30000 }`

`200 OK`

Content Examples:

When including the optional `itemId`.

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

When omitting the optional `itemId`.

`{ "positionMillis" : 30000 }`

200Success Code: 200 OK Content Examples: When including the optional itemId. JavaScript{ "positionMillis" : 30000, "itemId" : "123" } When omitting the optional itemId. JavaScript{ "positionMillis" : 30000 }

400Success Code: 200 OK Content Examples: When including the optional itemId. JavaScript{ "positionMillis" : 30000, "itemId" : "123" } When omitting the optional itemId. JavaScript{ "positionMillis" : 30000 }

404Success Code: 200 OK Content Examples: When including the optional itemId. JavaScript{ "positionMillis" : 30000, "itemId" : "123" } When omitting the optional itemId. JavaScript{ "positionMillis" : 30000 }

499Success Code: 200 OK Content Examples: When including the optional itemId. JavaScript{ "positionMillis" : 30000, "itemId" : "123" } When omitting the optional itemId. JavaScript{ "positionMillis" : 30000 }

`200 OK`

Content Examples:

When including the optional `itemId`.

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

When omitting the optional `itemId`.

`{ "positionMillis" : 30000 }`

`200 OK`

Content Examples:

When including the optional `itemId`.

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

When omitting the optional `itemId`.

`{ "positionMillis" : 30000 }`

`200 OK`

Content Examples:

When including the optional `itemId`.

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

When omitting the optional `itemId`.

`{ "positionMillis" : 30000 }`

`200 OK`

Content Examples:

When including the optional `itemId`.

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

When omitting the optional `itemId`.

`{ "positionMillis" : 30000 }`