---
title: "Changes to Create a bookmark"
method: PUT
path: "/bookmarks"
---

# Changes to Create a bookmark

`PUT /bookmarks`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 57 revisions.

- **2026-08-09** `535feee32afb`: 1 info
- **2026-08-07** `b152883a37a3`: 1 info
- **2026-07-31** `1e49346294e8`: 1 info
- **2026-07-31** `48f80d018de4`: 3 info
- **2026-07-31** `e8e6b266ea29`: 9 info
- **2026-07-31** `2ff18e50dcc1`: 11 info
- **2026-07-31** `2db906b9afb1`: 1 info
- **2026-02-26** `c3f202b17eb7`: 1 breaking
- **2026-02-24** `3c57979a295f`: 1 info

## Changes

- **2026-08-09** `535feee32afb`: 1 info
  - added the required property `song/items/mood` to the response with the `200` status
- **2026-08-07** `b152883a37a3`: 1 info
  - added the required property `song/items/bpm` to the response with the `200` status
- **2026-07-31** `1e49346294e8`: 1 info
  - added the required property `video/items/catalog` to the response with the `200` status
- **2026-07-31** `48f80d018de4`: 3 info
  - added the required property `podcast_episode/items/last_played` to the response with the `200` status
  - added the required property `song/items/last_played` to the response with the `200` status
  - added the required property `video/items/last_played` to the response with the `200` status
- **2026-07-31** `e8e6b266ea29`: 9 info
  - api operation id `bookmarkCreate` was added
  - added optional request body
  - the `query` request parameter `filter` became optional
  - the `query` request parameter `position` became optional
  - the `query` request parameter `type` became optional
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `500`
- **2026-07-31** `2ff18e50dcc1`: 11 info
  - added the optional property `podcast_episode` to the response with the `200` status
  - added the optional property `song` to the response with the `200` status
  - added the optional property `video` to the response with the `200` status
  - added the required property `client` to the response with the `200` status
  - added the required property `creation_date` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `object_id` to the response with the `200` status
  - added the required property `object_type` to the response with the `200` status
  - added the required property `owner` to the response with the `200` status
  - added the required property `position` to the response with the `200` status
  - added the required property `update_date` to the response with the `200` status
- **2026-07-31** `2db906b9afb1`: 1 info
  - endpoint added
- **2026-02-26** `c3f202b17eb7`: 1 breaking
  - api removed without deprecation
- **2026-02-24** `3c57979a295f`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/ampache/apis/ampache-rest-api/docs/bookmarks/put.md) - [API](https://skmtc.dev/ampache/apis/ampache-rest-api.md) - [Page](https://skmtc.dev/ampache/apis/ampache-rest-api/changes/bookmarks/put)