Get all bookmarks for an account
Request
To get all bookmarks for an account, send a GET request to:
https://<host>:<port>/useractivityvault/v1/clientdata/account/{account}/bookmarks
This API supports:
- Filtering by tag
- Limiting the number of records returned and specifying paging
- Sorting results chronologically by modification date (ascending or descending)
- Sorting results by content ID
Headers
Authorization: Bearer
– bearer tokenContent-Type: application/json
Mandatory arguments
account
– the account ID (in the path)sort
– the parameter on which to sort the bookmarks. Allowed values:contentId
(default)modifiedDateAsc
modifiedDateDesc
Other arguments
pretty
– specifies that the output should be pretty-printed (that is, in human-readable format) (query parameter)fields
– specifies which fields to return (query parameter). By default, all fields are returned.limit
– the number of records to return (query parameter)offset
– the number of records to skip (for pagination) (query parameter)
For example:?limit=10
returns the first 10 bookmarks.?limit=10&offset=10
returns the second 10 bookmarks.
filter
– specifies the tag to filter by (query parameter). You can only specify one tag here.
Response
A successful request returns an HTTP 200 status.
A bad request returns an HTTP 400 status.
An unauthorised request returns an HTTP 401 status.
Example
1. {
2. "bookmarks": [
3. {
4. "account": "1",
5. "userId": "",
6. "deviceId": "333",
7. "contentId": "trainspotting",
8. "name": "n",
9. "contentType": "asset",
10. "position": 30,
11. "creationDate": "2021-01-22T08:52:51Z",
12. "modifiedDate": "2021-01-22T08:52:51Z",
13. "metadata": {},
14. "tags": []
15. },
16. {
17. "account": "1",
18. "userId": "",
19. "contentId": "trainspottingg",
20. "contentType": "asset",
21. "position": 30,
22. "creationDate": "2021-01-22T08:47:41Z",
23. "modifiedDate": "2021-01-22T08:47:41Z",
24. "metadata": {},
25. "tags": []
26. }
27. ],
28. "totalRecords": 2
29. }
See also
For full details of this API, see the User Activity Vault (UAV) API documentation.