v38

latestOpenAPI 3.0.3AGPL-3.0raw.githubusercontent.com2026-08-022461333.9 MB

Bookmarks

Create a bookmark

Create a placeholder for the current media that you can return to later.

put/bookmarks

Query parameters

filterstring

Object id

type'song' | 'video' | 'podcast_episode'

positioninteger

Current track time in seconds

clientstring

Client/agent name recorded with the request.

dateinteger

UNIXTIME()

include0 | 1

Request body

filterstring required

Object id

type'song' | 'video' | 'podcast_episode' required

positioninteger required

Current track time in seconds

clientstring

Client/agent name recorded with the request.

dateinteger

UNIXTIME()

include0 | 1

Response

Bookmark created

idstring required

ownerstring required

object_typestring nullable required

The kind of object referenced, as a bare string. The set is intentionally open so a new media type is not a breaking change; values seen today include song, album, artist, playlist, podcast, podcast_episode and video.

object_idstring required

positioninteger required

clientstring nullable required

creation_dateinteger required

update_dateinteger required