Lumilio-Photos API (1.0)

Get a paginated list of jobs with optional state, queue, kind, and time range filters

Get detailed information about a specific job

Get a list of all active queues with their metadata

Get aggregated statistics about jobs by state

Send a query to agent and receive streaming responses via SSE. Manages conversation threads.

Resume a conversation from an interrupt point (e.g., user confirmation for a tool call)

Get all DTO schemas used by agent tools for type reference

Get list of all registered agent tools

Retrieve a paginated list of albums for the authenticated user

Create a new album for the authenticated user

Delete an album by its ID

Retrieve a specific album by its ID

Update an existing album's information

Retrieve all assets in a specific album

Remove an asset from a specific album

Add an asset to a specific album

Update the position of an asset within a specific album

Retrieve all albums that contain a specific asset

Upload a single photo, video, audio file, or document to the system. The file is staged in a repository and queued for processing.

Soft delete an asset by marking it as deleted. The physical file is not removed.

Retrieve detailed information about a specific asset. Optionally include thumbnails, tags, albums, species predictions, OCR results, face recognition, and captions.

Update the specific metadata of an asset (e.g., photo EXIF data, video metadata).

Associate an asset with a specific album by asset ID and album ID.

Serve the web-optimized MP3 audio version for an asset by asset ID.

Update the description metadata of an asset

Update the like/favorite status of a specific asset

Serve the original file content for an asset by asset ID. Returns the file as an octet-stream.

Update the rating (0-5) of a specific asset

Update both the rating (0-5) and like/favorite status of a specific asset

Reprocess a failed or warning asset by resetting its status and re-enqueuing for processing

Retrieve a specific thumbnail image for an asset by asset ID and size parameter. Returns the image file directly.

Serve the web-optimized MP4 video version for an asset by asset ID.

Unified batch upload endpoint that supports both small files and chunked large files. Field names should follow format: single_{session_id} for single files or chunk_{session_id}{index}{total} for chunks.

Get current upload configuration including chunk size and concurrency limits based on system memory

Get detailed progress information for upload sessions

Select a small set of featured photos using deterministic weighted sampling (A-ES) with diversity constraints.

Get available camera makes and lenses for filter dropdowns

Queue a background batch that backfills AI indexing for existing photos.

Return repositories that can be used to scope indexing stats and reindex requests.

Return indexing coverage and queued job counts for photo AI tasks.

Get all assets that have been liked/favorited

Unified endpoint for listing, filtering, and searching assets. Replaces separate /filter and /search endpoints.

Return lightweight paginated photo records containing only map-related fields (asset ID, filename, times, GPS lat/lon).

Get assets with a specific rating (0-5)

Search assets with optional top results enhancement and filename fallback.

Retrieve a list of all supported asset types in the system.

Return whether Lumilio is still in first-user bootstrap mode and which role the next registration receives.

Authenticate user with username and password. Returns an MFA challenge instead of session tokens when TOTP is enabled.

Revoke the user's refresh token