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
List all libraries owned by the authenticated user
curl --request GET \
--url https://api.example.com/api/libraries[
{
"id": "<string>",
"name": "<string>",
"user_id": "<string>",
"asset_count": 123,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"description": "<string>"
}
]libraries
List all libraries owned by the authenticated user
Returns every library the user owns (no pagination — users typically have one or a handful). Call this when another tool’s library_id parameter is required but you don’t yet know which libraries exist. A single-library user can usually omit library_id on other tools entirely.
GET
/
api
/
libraries
List all libraries owned by the authenticated user
curl --request GET \
--url https://api.example.com/api/libraries[
{
"id": "<string>",
"name": "<string>",
"user_id": "<string>",
"asset_count": 123,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"description": "<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.
Response
Successful Response
Unique library identifier with 'lib_' prefix
Display name of the library
ID of the user who owns this library
Total number of assets in this library
When this library was created
When this library was last updated
Optional description text for the library
Stream entity change events for client sync (use to keep a local cache in sync)
Previous
Create a new photo library for the authenticated user
Next
⌘I