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
curl --request GET \
--url https://api.example.com/api/users/me{
"id": "<string>",
"is_active": true,
"is_superuser": true,
"is_verified": true,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"email": "<string>",
"first_name": "<string>",
"last_name": "<string>"
}Get profile for the authenticated user (the caller)
Returns the authenticated caller’s profile. Use this at the start of a session to ground subsequent calls (e.g., to confirm the caller’s identity before making destructive changes). This tool does not accept a user ID; it always returns the authenticated caller.
curl --request GET \
--url https://api.example.com/api/users/me{
"id": "<string>",
"is_active": true,
"is_superuser": true,
"is_verified": true,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"email": "<string>",
"first_name": "<string>",
"last_name": "<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
Represents a user account with profile information.
Unique user identifier with 'intuser_' prefix
Whether this user account is currently active
Whether this user has superuser/admin privileges
Whether this user's email is verified
When this user account was created
When this user account was last updated
User's email address
User's first name
User's last name