oauth
assets
- GETList assets in a library, optionally filtered by album, person, date range, or asset ID
- POSTUpload a new asset
- DELPermanently delete the specified assets and their underlying files
- GETGet asset counts
- POSTCheck asset existence
- POSTMove assets to trash
- POSTRestore assets from trash
- POSTPermanently delete every trashed asset in the library
- GETGet full metadata for a single asset by ID
- DELPermanently delete an asset and its underlying file
album-assets
albums
- GETList albums in a library, optionally filtered by asset membership or ID
- POSTCreate a new, empty album in a library
- GETGet metadata for a single album by ID
- DELDelete an album (the assets inside it are kept)
- PATCHRename an album or change its description
- POSTAdd existing assets to an album
- DELRemove assets from an album (assets themselves are kept)
libraries
faces
people
- GETList people in a library, optionally filtered by asset, album, name, or ID
- POSTCreate a new person record (a named identity for grouping faces)
- GETGet metadata for a single person by ID
- DELDelete a person record; its faces become unassigned and will be re-clustered
- PATCHUpdate a person's name, birth date, visibility, or thumbnail
- POSTMerge people
server
Add existing assets to an album
curl --request POST \
--url https://api.example.com/api/albums/{album_id}/assets \
--header 'Content-Type: application/json' \
--data '
{
"asset_ids": [
"<string>"
]
}
'{
"added_assets": [
"<string>"
],
"duplicate_assets": [
"<string>"
]
}albums
Add existing assets to an album
Adds one or more existing assets to the specified album. Assets must already be in the same library as the album (this tool does not upload new assets). Assets already in the album are silently skipped and returned separately as duplicate_assets. Idempotent: calling with the same IDs twice leaves the album in the same state.
POST
/
api
/
albums
/
{album_id}
/
assets
Add existing assets to an album
curl --request POST \
--url https://api.example.com/api/albums/{album_id}/assets \
--header 'Content-Type: application/json' \
--data '
{
"asset_ids": [
"<string>"
]
}
'{
"added_assets": [
"<string>"
],
"duplicate_assets": [
"<string>"
]
}Documentation Index
Fetch the complete documentation index at: https://docs.gumnut.ai/llms.txt
Use this file to discover all available pages before exploring further.
Path Parameters
Album ID (with album_ prefix) of the album to add the assets to.
Body
application/json
Asset IDs (with asset_ prefix) to associate with the album. Get IDs from list_assets, search_assets, or list_album_assets.
Rename an album or change its description
Previous
Remove assets from an album (assets themselves are kept)
Next
⌘I