Albums12

Artists7

Artwork7

Authentication5

Bookmarks17

Browsing, Indexes and Lists13

Catalogs17

Collections8

Genres6

Labels5

Licenses3

Live Streams5

Localplay1

Maintenance4

Now Playing6

Playback Control18

Playlist Folders8

Playlists18

Podcasts13

Preferences7

Ratings and Flags18

Search2

Shares13

Social6

Song1

Songs8

Streaming and Downloads9

Users7

Utilities7

Videos3

Bookmarks

Create a bookmark

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

put/videos/{video_id}/bookmark

Path parameters

video_idstring required

Unique identifier of the video.

Query parameters

positioninteger

clientstring

Client/agent name recorded with the request.

dateinteger

include0 | 1

Request body

positioninteger required

clientstring

Client/agent name recorded with the request.

dateinteger

include0 | 1

Response

Bookmark object

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

Changes

Changed in 10 of the 46 revisions of this API.127

Aug 9, 2026535feee32afb1See the full diff
- ○
  added the required property // to the response with the status
  response-required-property-added
Aug 7, 2026b152883a37a31See the full diff
- ○
  added the required property // to the response with the status
  response-required-property-added
Jul 29, 20261e49346294e81See the full diff
- ○
  added the required property // to the response with the status
  response-required-property-added
Jul 28, 202648f80d018de43See the full diff
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
Jul 22, 2026e8e6b266ea297See the full diff
- ○
  api operation id bookmarkCreateVideos was added
  api-operation-id-added
- ○
  added optional request body
  request-body-added-optional
- ○
  the query request parameter position became optional
  request-parameter-became-optional
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
Jul 21, 20262ff18e50dcc111See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
Jul 17, 20269abb9bf6d3bf1See the full diff
- ○
  removed the non-success response with the status
  response-non-success-status-removed
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 25, 20267ed7a764efd91See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
Feb 26, 2026c3f202b17eb71See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 19, 202607f53972fdd71See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation

Full history