Favorites API
Endpoints for managing favorite items.
List Favorites
Get all favorited items.
Response
[
{
"id": 5,
"path": "photos/vacation/beach.jpg",
"name": "beach.jpg",
"type": "image",
"parentPath": "photos/vacation",
"createdAt": "2026-04-03T18:25:19Z"
},
{
"path": "videos/highlights",
"name": "highlights",
"type": "folder"
}
]
Add Favorite
Add an item to favorites.
Request
Response
Remove Favorite
Remove an item from favorites.
Request
Response
Bulk Add Favorites
Add multiple items to favorites at once.
Request
{
"items": [
{
"path": "photos/vacation/beach.jpg",
"name": "beach.jpg",
"type": "image"
},
{
"path": "photos/vacation/sunset.jpg",
"name": "sunset.jpg",
"type": "image"
}
]
}
Response
Notes
- Up to 100 items are processed per request.
- Empty paths are ignored.
- Error lists are truncated to avoid oversized responses.
Bulk Remove Favorites
Remove multiple favorites at once.
Request
Response
Reorder Favorites
Replace the display order of the favorites strip.
Request
Response
For exact request and response schemas, see the OpenAPI specification.