Search Bookmarks through Bookmarks API

Hi,

I was using the SOAP method RecorderCommandService.BookmarkSearchTimeAsync, but this SOAP Api is now flagged as legacy.

The new bookmarks API has an endpoint (“bookmarks?task=searchTime”) which seems to behave similarly.

However, the request body documentation only has the field “searchHeader” (boolean) but no way to actually pass the value to search for.

Moreover, I cannot search for camera ids which was also possible with the SOAP endpoint.

What is the correct way to search for bookmarks related to a camera and with a specific header?

I appreciate any help regarding this!

For searchTime, add a “searchText” : “what-to-find” field. Also be sure to include the type like “resourceTypes” : [ “cameras” ], or the “devicePaths” : [ { “type” : “cameras”, “id” : “some_id”} ]

More info here:

https://doc.developer.milestonesys.com/mipvmsapi/api/bookmarks-rest/v1/#tag/Bookmarks/operation/bookmarks_Post

To get a specific bookmark you do a GET /bookmarks/{id-of-bookmark}

I did a quick test:

POST /api/rest/v1/bookmarks?task=searchTime

{

“time”: “2025-10-09T10:30:22Z”,

“searchText”: “Quick bookmark”,

“devicePaths” : [ { “type” : “cameras”, “id” : “db7b91a8-572d-4334-8314-832d6d9dbc82”} ],

“timeLimit”: “20:00:00”,

“countLimit”: 3,

“searchHeader”: true

}

Thank you very much!