docs(openapi): add descriptions to OpenAPI specification (#25185)

* faces

* add openapi descriptions

* remove dto descriptions

* gen openapi

* dtos

* fix dtos

* fix more

* fix build

* more

* complete dtos

* descriptions on rebase

* gen rebase

* revert correct integer type conversion

* gen after revert

* revert correct nullables

* regen after revert

* actually incorrect adding default here

* revert correct number type conversion

* regen after revert

* revert nullable usage

* regen fully

* readd some comments

* one more

* one more

* use enum

* add missing

* add missing controllers

* add missing dtos

* complete it

* more

* describe global key and slug

* add remaining body and param descriptions

* lint and format

* cleanup

* response and schema descriptions

* test patch according to suggestion

* revert added api response objects

* revert added api body objects

* revert added api param object

* revert added api query objects

* revert reorganized http code objects

* revert reorganize ApiOkResponse objects

* revert added api response objects (2)

* revert added api tag object

* revert added api schema objects

* migrate missing asset.dto.ts

* regenerate openapi builds

* delete generated mustache files

* remove descriptions from properties that are schemas

* lint

* revert nullable type changes

* revert int/num type changes

* remove explicit default

* readd comment

* lint

* pr fixes

* last bits and pieces

* lint and format

* chore: remove rejected patches

* fix: deleting asset from asset-viewer on search results (#25596)

* fix: escape handling in search asset viewer (#25621)

* fix: correctly show owner in album options modal (#25618)

* fix: validation issues

* fix: validation issues

---------

Co-authored-by: Jason Rasmussen <jason@rasm.me>
Co-authored-by: Min Idzelis <min123@gmail.com>
Co-authored-by: Daniel Dietzler <36593685+danieldietzler@users.noreply.github.com>
Co-authored-by: Paul Makles <me@insrt.uk>

mobile/openapi/lib/api/activities_api.dart

@@ -130,14 +130,19 @@ class ActivitiesApi {
   /// Parameters:
   ///
   /// * [String] albumId (required):
+  ///   Album ID
   ///
   /// * [String] assetId:
+  ///   Asset ID (if activity is for an asset)
   ///
   /// * [ReactionLevel] level:
+  ///   Filter by activity level
   ///
   /// * [ReactionType] type:
+  ///   Filter by activity type
   ///
   /// * [String] userId:
+  ///   Filter by user ID
   Future<Response> getActivitiesWithHttpInfo(String albumId, { String? assetId, ReactionLevel? level, ReactionType? type, String? userId, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/activities';
@@ -184,14 +189,19 @@ class ActivitiesApi {
   /// Parameters:
   ///
   /// * [String] albumId (required):
+  ///   Album ID
   ///
   /// * [String] assetId:
+  ///   Asset ID (if activity is for an asset)
   ///
   /// * [ReactionLevel] level:
+  ///   Filter by activity level
   ///
   /// * [ReactionType] type:
+  ///   Filter by activity type
   ///
   /// * [String] userId:
+  ///   Filter by user ID
   Future<List<ActivityResponseDto>?> getActivities(String albumId, { String? assetId, ReactionLevel? level, ReactionType? type, String? userId, }) async {
     final response = await getActivitiesWithHttpInfo(albumId,  assetId: assetId, level: level, type: type, userId: userId, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -219,8 +229,10 @@ class ActivitiesApi {
   /// Parameters:
   ///
   /// * [String] albumId (required):
+  ///   Album ID
   ///
   /// * [String] assetId:
+  ///   Asset ID (if activity is for an asset)
   Future<Response> getActivityStatisticsWithHttpInfo(String albumId, { String? assetId, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/activities/statistics';
@@ -258,8 +270,10 @@ class ActivitiesApi {
   /// Parameters:
   ///
   /// * [String] albumId (required):
+  ///   Album ID
   ///
   /// * [String] assetId:
+  ///   Asset ID (if activity is for an asset)
   Future<ActivityStatisticsResponseDto?> getActivityStatistics(String albumId, { String? assetId, }) async {
     final response = await getActivityStatisticsWithHttpInfo(albumId,  assetId: assetId, );
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/albums_api.dart

@@ -347,6 +347,7 @@ class AlbumsApi {
   /// * [String] slug:
   ///
   /// * [bool] withoutAssets:
+  ///   Exclude assets from response
   Future<Response> getAlbumInfoWithHttpInfo(String id, { String? key, String? slug, bool? withoutAssets, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/albums/{id}'
@@ -396,6 +397,7 @@ class AlbumsApi {
   /// * [String] slug:
   ///
   /// * [bool] withoutAssets:
+  ///   Exclude assets from response
   Future<AlbumResponseDto?> getAlbumInfo(String id, { String? key, String? slug, bool? withoutAssets, }) async {
     final response = await getAlbumInfoWithHttpInfo(id,  key: key, slug: slug, withoutAssets: withoutAssets, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -468,9 +470,10 @@ class AlbumsApi {
   /// Parameters:
   ///
   /// * [String] assetId:
-  ///   Only returns albums that contain the asset Ignores the shared parameter undefined: get all albums
+  ///   Filter albums containing this asset ID (ignores shared parameter)
   ///
   /// * [bool] shared:
+  ///   Filter by shared status: true = only shared, false = only own, undefined = all
   Future<Response> getAllAlbumsWithHttpInfo({ String? assetId, bool? shared, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/albums';
@@ -510,9 +513,10 @@ class AlbumsApi {
   /// Parameters:
   ///
   /// * [String] assetId:
-  ///   Only returns albums that contain the asset Ignores the shared parameter undefined: get all albums
+  ///   Filter albums containing this asset ID (ignores shared parameter)
   ///
   /// * [bool] shared:
+  ///   Filter by shared status: true = only shared, false = only own, undefined = all
   Future<List<AlbumResponseDto>?> getAllAlbums({ String? assetId, bool? shared, }) async {
     final response = await getAllAlbumsWithHttpInfo( assetId: assetId, shared: shared, );
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/assets_api.dart

@@ -185,8 +185,10 @@ class AssetsApi {
   /// Parameters:
   ///
   /// * [String] id (required):
+  ///   Asset ID
   ///
   /// * [String] key (required):
+  ///   Metadata key
   Future<Response> deleteAssetMetadataWithHttpInfo(String id, String key,) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/assets/{id}/metadata/{key}'
@@ -221,8 +223,10 @@ class AssetsApi {
   /// Parameters:
   ///
   /// * [String] id (required):
+  ///   Asset ID
   ///
   /// * [String] key (required):
+  ///   Metadata key
   Future<void> deleteAssetMetadata(String id, String key,) async {
     final response = await deleteAssetMetadataWithHttpInfo(id, key,);
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -337,6 +341,7 @@ class AssetsApi {
   /// * [String] id (required):
   ///
   /// * [bool] edited:
+  ///   Return edited asset if available
   ///
   /// * [String] key:
   ///
@@ -386,6 +391,7 @@ class AssetsApi {
   /// * [String] id (required):
   ///
   /// * [bool] edited:
+  ///   Return edited asset if available
   ///
   /// * [String] key:
   ///
@@ -475,6 +481,7 @@ class AssetsApi {
   /// Parameters:
   ///
   /// * [String] deviceId (required):
+  ///   Device ID
   Future<Response> getAllUserAssetsByDeviceIdWithHttpInfo(String deviceId,) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/assets/device/{deviceId}'
@@ -508,6 +515,7 @@ class AssetsApi {
   /// Parameters:
   ///
   /// * [String] deviceId (required):
+  ///   Device ID
   Future<List<String>?> getAllUserAssetsByDeviceId(String deviceId,) async {
     final response = await getAllUserAssetsByDeviceIdWithHttpInfo(deviceId,);
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -724,8 +732,10 @@ class AssetsApi {
   /// Parameters:
   ///
   /// * [String] id (required):
+  ///   Asset ID
   ///
   /// * [String] key (required):
+  ///   Metadata key
   Future<Response> getAssetMetadataByKeyWithHttpInfo(String id, String key,) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/assets/{id}/metadata/{key}'
@@ -760,8 +770,10 @@ class AssetsApi {
   /// Parameters:
   ///
   /// * [String] id (required):
+  ///   Asset ID
   ///
   /// * [String] key (required):
+  ///   Metadata key
   Future<AssetMetadataResponseDto?> getAssetMetadataByKey(String id, String key,) async {
     final response = await getAssetMetadataByKeyWithHttpInfo(id, key,);
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -846,10 +858,13 @@ class AssetsApi {
   /// Parameters:
   ///
   /// * [bool] isFavorite:
+  ///   Filter by favorite status
   ///
   /// * [bool] isTrashed:
+  ///   Filter by trash status
   ///
   /// * [AssetVisibility] visibility:
+  ///   Filter by visibility
   Future<Response> getAssetStatisticsWithHttpInfo({ bool? isFavorite, bool? isTrashed, AssetVisibility? visibility, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/assets/statistics';
@@ -892,10 +907,13 @@ class AssetsApi {
   /// Parameters:
   ///
   /// * [bool] isFavorite:
+  ///   Filter by favorite status
   ///
   /// * [bool] isTrashed:
+  ///   Filter by trash status
   ///
   /// * [AssetVisibility] visibility:
+  ///   Filter by visibility
   Future<AssetStatsResponseDto?> getAssetStatistics({ bool? isFavorite, bool? isTrashed, AssetVisibility? visibility, }) async {
     final response = await getAssetStatisticsWithHttpInfo( isFavorite: isFavorite, isTrashed: isTrashed, visibility: visibility, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -920,6 +938,7 @@ class AssetsApi {
   /// Parameters:
   ///
   /// * [num] count:
+  ///   Number of random assets to return
   Future<Response> getRandomWithHttpInfo({ num? count, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/assets/random';
@@ -956,6 +975,7 @@ class AssetsApi {
   /// Parameters:
   ///
   /// * [num] count:
+  ///   Number of random assets to return
   Future<List<AssetResponseDto>?> getRandom({ num? count, }) async {
     final response = await getRandomWithHttpInfo( count: count, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -1106,22 +1126,29 @@ class AssetsApi {
   /// * [String] id (required):
   ///
   /// * [MultipartFile] assetData (required):
+  ///   Asset file data
   ///
   /// * [String] deviceAssetId (required):
+  ///   Device asset ID
   ///
   /// * [String] deviceId (required):
+  ///   Device ID
   ///
   /// * [DateTime] fileCreatedAt (required):
+  ///   File creation date
   ///
   /// * [DateTime] fileModifiedAt (required):
+  ///   File modification date
   ///
   /// * [String] key:
   ///
   /// * [String] slug:
   ///
   /// * [String] duration:
+  ///   Duration (for videos)
   ///
   /// * [String] filename:
+  ///   Filename
   Future<Response> replaceAssetWithHttpInfo(String id, MultipartFile assetData, String deviceAssetId, String deviceId, DateTime fileCreatedAt, DateTime fileModifiedAt, { String? key, String? slug, String? duration, String? filename, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/assets/{id}/original'
@@ -1198,22 +1225,29 @@ class AssetsApi {
   /// * [String] id (required):
   ///
   /// * [MultipartFile] assetData (required):
+  ///   Asset file data
   ///
   /// * [String] deviceAssetId (required):
+  ///   Device asset ID
   ///
   /// * [String] deviceId (required):
+  ///   Device ID
   ///
   /// * [DateTime] fileCreatedAt (required):
+  ///   File creation date
   ///
   /// * [DateTime] fileModifiedAt (required):
+  ///   File modification date
   ///
   /// * [String] key:
   ///
   /// * [String] slug:
   ///
   /// * [String] duration:
+  ///   Duration (for videos)
   ///
   /// * [String] filename:
+  ///   Filename
   Future<AssetMediaResponseDto?> replaceAsset(String id, MultipartFile assetData, String deviceAssetId, String deviceId, DateTime fileCreatedAt, DateTime fileModifiedAt, { String? key, String? slug, String? duration, String? filename, }) async {
     final response = await replaceAssetWithHttpInfo(id, assetData, deviceAssetId, deviceId, fileCreatedAt, fileModifiedAt,  key: key, slug: slug, duration: duration, filename: filename, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -1518,14 +1552,19 @@ class AssetsApi {
   /// Parameters:
   ///
   /// * [MultipartFile] assetData (required):
+  ///   Asset file data
   ///
   /// * [String] deviceAssetId (required):
+  ///   Device asset ID
   ///
   /// * [String] deviceId (required):
+  ///   Device ID
   ///
   /// * [DateTime] fileCreatedAt (required):
+  ///   File creation date
   ///
   /// * [DateTime] fileModifiedAt (required):
+  ///   File modification date
   ///
   /// * [String] key:
   ///
@@ -1535,18 +1574,25 @@ class AssetsApi {
   ///   sha1 checksum that can be used for duplicate detection before the file is uploaded
   ///
   /// * [String] duration:
+  ///   Duration (for videos)
   ///
   /// * [String] filename:
+  ///   Filename
   ///
   /// * [bool] isFavorite:
+  ///   Mark as favorite
   ///
   /// * [String] livePhotoVideoId:
+  ///   Live photo video ID
   ///
   /// * [List<AssetMetadataUpsertItemDto>] metadata:
+  ///   Asset metadata items
   ///
   /// * [MultipartFile] sidecarData:
+  ///   Sidecar file data
   ///
   /// * [AssetVisibility] visibility:
+  ///   Asset visibility
   Future<Response> uploadAssetWithHttpInfo(MultipartFile assetData, String deviceAssetId, String deviceId, DateTime fileCreatedAt, DateTime fileModifiedAt, { String? key, String? slug, String? xImmichChecksum, String? duration, String? filename, bool? isFavorite, String? livePhotoVideoId, List<AssetMetadataUpsertItemDto>? metadata, MultipartFile? sidecarData, AssetVisibility? visibility, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/assets';
@@ -1645,14 +1691,19 @@ class AssetsApi {
   /// Parameters:
   ///
   /// * [MultipartFile] assetData (required):
+  ///   Asset file data
   ///
   /// * [String] deviceAssetId (required):
+  ///   Device asset ID
   ///
   /// * [String] deviceId (required):
+  ///   Device ID
   ///
   /// * [DateTime] fileCreatedAt (required):
+  ///   File creation date
   ///
   /// * [DateTime] fileModifiedAt (required):
+  ///   File modification date
   ///
   /// * [String] key:
   ///
@@ -1662,18 +1713,25 @@ class AssetsApi {
   ///   sha1 checksum that can be used for duplicate detection before the file is uploaded
   ///
   /// * [String] duration:
+  ///   Duration (for videos)
   ///
   /// * [String] filename:
+  ///   Filename
   ///
   /// * [bool] isFavorite:
+  ///   Mark as favorite
   ///
   /// * [String] livePhotoVideoId:
+  ///   Live photo video ID
   ///
   /// * [List<AssetMetadataUpsertItemDto>] metadata:
+  ///   Asset metadata items
   ///
   /// * [MultipartFile] sidecarData:
+  ///   Sidecar file data
   ///
   /// * [AssetVisibility] visibility:
+  ///   Asset visibility
   Future<AssetMediaResponseDto?> uploadAsset(MultipartFile assetData, String deviceAssetId, String deviceId, DateTime fileCreatedAt, DateTime fileModifiedAt, { String? key, String? slug, String? xImmichChecksum, String? duration, String? filename, bool? isFavorite, String? livePhotoVideoId, List<AssetMetadataUpsertItemDto>? metadata, MultipartFile? sidecarData, AssetVisibility? visibility, }) async {
     final response = await uploadAssetWithHttpInfo(assetData, deviceAssetId, deviceId, fileCreatedAt, fileModifiedAt,  key: key, slug: slug, xImmichChecksum: xImmichChecksum, duration: duration, filename: filename, isFavorite: isFavorite, livePhotoVideoId: livePhotoVideoId, metadata: metadata, sidecarData: sidecarData, visibility: visibility, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -1700,10 +1758,12 @@ class AssetsApi {
   /// * [String] id (required):
   ///
   /// * [bool] edited:
+  ///   Return edited asset if available
   ///
   /// * [String] key:
   ///
   /// * [AssetMediaSize] size:
+  ///   Asset media size
   ///
   /// * [String] slug:
   Future<Response> viewAssetWithHttpInfo(String id, { bool? edited, String? key, AssetMediaSize? size, String? slug, }) async {
@@ -1754,10 +1814,12 @@ class AssetsApi {
   /// * [String] id (required):
   ///
   /// * [bool] edited:
+  ///   Return edited asset if available
   ///
   /// * [String] key:
   ///
   /// * [AssetMediaSize] size:
+  ///   Asset media size
   ///
   /// * [String] slug:
   Future<MultipartFile?> viewAsset(String id, { bool? edited, String? key, AssetMediaSize? size, String? slug, }) async {

mobile/openapi/lib/api/deprecated_api.dart

@@ -82,6 +82,7 @@ class DeprecatedApi {
   /// Parameters:
   ///
   /// * [String] deviceId (required):
+  ///   Device ID
   Future<Response> getAllUserAssetsByDeviceIdWithHttpInfo(String deviceId,) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/assets/device/{deviceId}'
@@ -115,6 +116,7 @@ class DeprecatedApi {
   /// Parameters:
   ///
   /// * [String] deviceId (required):
+  ///   Device ID
   Future<List<String>?> getAllUserAssetsByDeviceId(String deviceId,) async {
     final response = await getAllUserAssetsByDeviceIdWithHttpInfo(deviceId,);
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -305,6 +307,7 @@ class DeprecatedApi {
   /// Parameters:
   ///
   /// * [num] count:
+  ///   Number of random assets to return
   Future<Response> getRandomWithHttpInfo({ num? count, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/assets/random';
@@ -341,6 +344,7 @@ class DeprecatedApi {
   /// Parameters:
   ///
   /// * [num] count:
+  ///   Number of random assets to return
   Future<List<AssetResponseDto>?> getRandom({ num? count, }) async {
     final response = await getRandomWithHttpInfo( count: count, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -370,22 +374,29 @@ class DeprecatedApi {
   /// * [String] id (required):
   ///
   /// * [MultipartFile] assetData (required):
+  ///   Asset file data
   ///
   /// * [String] deviceAssetId (required):
+  ///   Device asset ID
   ///
   /// * [String] deviceId (required):
+  ///   Device ID
   ///
   /// * [DateTime] fileCreatedAt (required):
+  ///   File creation date
   ///
   /// * [DateTime] fileModifiedAt (required):
+  ///   File modification date
   ///
   /// * [String] key:
   ///
   /// * [String] slug:
   ///
   /// * [String] duration:
+  ///   Duration (for videos)
   ///
   /// * [String] filename:
+  ///   Filename
   Future<Response> replaceAssetWithHttpInfo(String id, MultipartFile assetData, String deviceAssetId, String deviceId, DateTime fileCreatedAt, DateTime fileModifiedAt, { String? key, String? slug, String? duration, String? filename, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/assets/{id}/original'
@@ -462,22 +473,29 @@ class DeprecatedApi {
   /// * [String] id (required):
   ///
   /// * [MultipartFile] assetData (required):
+  ///   Asset file data
   ///
   /// * [String] deviceAssetId (required):
+  ///   Device asset ID
   ///
   /// * [String] deviceId (required):
+  ///   Device ID
   ///
   /// * [DateTime] fileCreatedAt (required):
+  ///   File creation date
   ///
   /// * [DateTime] fileModifiedAt (required):
+  ///   File modification date
   ///
   /// * [String] key:
   ///
   /// * [String] slug:
   ///
   /// * [String] duration:
+  ///   Duration (for videos)
   ///
   /// * [String] filename:
+  ///   Filename
   Future<AssetMediaResponseDto?> replaceAsset(String id, MultipartFile assetData, String deviceAssetId, String deviceId, DateTime fileCreatedAt, DateTime fileModifiedAt, { String? key, String? slug, String? duration, String? filename, }) async {
     final response = await replaceAssetWithHttpInfo(id, assetData, deviceAssetId, deviceId, fileCreatedAt, fileModifiedAt,  key: key, slug: slug, duration: duration, filename: filename, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -502,6 +520,7 @@ class DeprecatedApi {
   /// Parameters:
   ///
   /// * [QueueName] name (required):
+  ///   Queue name
   ///
   /// * [QueueCommandDto] queueCommandDto (required):
   Future<Response> runQueueCommandLegacyWithHttpInfo(QueueName name, QueueCommandDto queueCommandDto,) async {
@@ -537,6 +556,7 @@ class DeprecatedApi {
   /// Parameters:
   ///
   /// * [QueueName] name (required):
+  ///   Queue name
   ///
   /// * [QueueCommandDto] queueCommandDto (required):
   Future<QueueResponseLegacyDto?> runQueueCommandLegacy(QueueName name, QueueCommandDto queueCommandDto,) async {

mobile/openapi/lib/api/faces_api.dart

@@ -126,6 +126,7 @@ class FacesApi {
   /// Parameters:
   ///
   /// * [String] id (required):
+  ///   Face ID
   Future<Response> getFacesWithHttpInfo(String id,) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/faces';
@@ -160,6 +161,7 @@ class FacesApi {
   /// Parameters:
   ///
   /// * [String] id (required):
+  ///   Face ID
   Future<List<AssetFaceResponseDto>?> getFaces(String id,) async {
     final response = await getFacesWithHttpInfo(id,);
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/jobs_api.dart

@@ -121,6 +121,7 @@ class JobsApi {
   /// Parameters:
   ///
   /// * [QueueName] name (required):
+  ///   Queue name
   ///
   /// * [QueueCommandDto] queueCommandDto (required):
   Future<Response> runQueueCommandLegacyWithHttpInfo(QueueName name, QueueCommandDto queueCommandDto,) async {
@@ -156,6 +157,7 @@ class JobsApi {
   /// Parameters:
   ///
   /// * [QueueName] name (required):
+  ///   Queue name
   ///
   /// * [QueueCommandDto] queueCommandDto (required):
   Future<QueueResponseLegacyDto?> runQueueCommandLegacy(QueueName name, QueueCommandDto queueCommandDto,) async {

mobile/openapi/lib/api/map_api.dart

@@ -25,16 +25,22 @@ class MapApi {
   /// Parameters:
   ///
   /// * [DateTime] fileCreatedAfter:
+  ///   Filter assets created after this date
   ///
   /// * [DateTime] fileCreatedBefore:
+  ///   Filter assets created before this date
   ///
   /// * [bool] isArchived:
+  ///   Filter by archived status
   ///
   /// * [bool] isFavorite:
+  ///   Filter by favorite status
   ///
   /// * [bool] withPartners:
+  ///   Include partner assets
   ///
   /// * [bool] withSharedAlbums:
+  ///   Include shared album assets
   Future<Response> getMapMarkersWithHttpInfo({ DateTime? fileCreatedAfter, DateTime? fileCreatedBefore, bool? isArchived, bool? isFavorite, bool? withPartners, bool? withSharedAlbums, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/map/markers';
@@ -86,16 +92,22 @@ class MapApi {
   /// Parameters:
   ///
   /// * [DateTime] fileCreatedAfter:
+  ///   Filter assets created after this date
   ///
   /// * [DateTime] fileCreatedBefore:
+  ///   Filter assets created before this date
   ///
   /// * [bool] isArchived:
+  ///   Filter by archived status
   ///
   /// * [bool] isFavorite:
+  ///   Filter by favorite status
   ///
   /// * [bool] withPartners:
+  ///   Include partner assets
   ///
   /// * [bool] withSharedAlbums:
+  ///   Include shared album assets
   Future<List<MapMarkerResponseDto>?> getMapMarkers({ DateTime? fileCreatedAfter, DateTime? fileCreatedBefore, bool? isArchived, bool? isFavorite, bool? withPartners, bool? withSharedAlbums, }) async {
     final response = await getMapMarkersWithHttpInfo( fileCreatedAfter: fileCreatedAfter, fileCreatedBefore: fileCreatedBefore, isArchived: isArchived, isFavorite: isFavorite, withPartners: withPartners, withSharedAlbums: withSharedAlbums, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -123,8 +135,10 @@ class MapApi {
   /// Parameters:
   ///
   /// * [double] lat (required):
+  ///   Latitude (-90 to 90)
   ///
   /// * [double] lon (required):
+  ///   Longitude (-180 to 180)
   Future<Response> reverseGeocodeWithHttpInfo(double lat, double lon,) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/map/reverse-geocode';
@@ -160,8 +174,10 @@ class MapApi {
   /// Parameters:
   ///
   /// * [double] lat (required):
+  ///   Latitude (-90 to 90)
   ///
   /// * [double] lon (required):
+  ///   Longitude (-180 to 180)
   Future<List<MapReverseGeocodeResponseDto>?> reverseGeocode(double lat, double lon,) async {
     final response = await reverseGeocodeWithHttpInfo(lat, lon,);
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/memories_api.dart

@@ -251,17 +251,22 @@ class MemoriesApi {
   /// Parameters:
   ///
   /// * [DateTime] for_:
+  ///   Filter by date
   ///
   /// * [bool] isSaved:
+  ///   Filter by saved status
   ///
   /// * [bool] isTrashed:
+  ///   Include trashed memories
   ///
   /// * [MemorySearchOrder] order:
+  ///   Sort order
   ///
   /// * [int] size:
   ///   Number of memories to return
   ///
   /// * [MemoryType] type:
+  ///   Memory type
   Future<Response> memoriesStatisticsWithHttpInfo({ DateTime? for_, bool? isSaved, bool? isTrashed, MemorySearchOrder? order, int? size, MemoryType? type, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/memories/statistics';
@@ -313,17 +318,22 @@ class MemoriesApi {
   /// Parameters:
   ///
   /// * [DateTime] for_:
+  ///   Filter by date
   ///
   /// * [bool] isSaved:
+  ///   Filter by saved status
   ///
   /// * [bool] isTrashed:
+  ///   Include trashed memories
   ///
   /// * [MemorySearchOrder] order:
+  ///   Sort order
   ///
   /// * [int] size:
   ///   Number of memories to return
   ///
   /// * [MemoryType] type:
+  ///   Memory type
   Future<MemoryStatisticsResponseDto?> memoriesStatistics({ DateTime? for_, bool? isSaved, bool? isTrashed, MemorySearchOrder? order, int? size, MemoryType? type, }) async {
     final response = await memoriesStatisticsWithHttpInfo( for_: for_, isSaved: isSaved, isTrashed: isTrashed, order: order, size: size, type: type, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -412,17 +422,22 @@ class MemoriesApi {
   /// Parameters:
   ///
   /// * [DateTime] for_:
+  ///   Filter by date
   ///
   /// * [bool] isSaved:
+  ///   Filter by saved status
   ///
   /// * [bool] isTrashed:
+  ///   Include trashed memories
   ///
   /// * [MemorySearchOrder] order:
+  ///   Sort order
   ///
   /// * [int] size:
   ///   Number of memories to return
   ///
   /// * [MemoryType] type:
+  ///   Memory type
   Future<Response> searchMemoriesWithHttpInfo({ DateTime? for_, bool? isSaved, bool? isTrashed, MemorySearchOrder? order, int? size, MemoryType? type, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/memories';
@@ -474,17 +489,22 @@ class MemoriesApi {
   /// Parameters:
   ///
   /// * [DateTime] for_:
+  ///   Filter by date
   ///
   /// * [bool] isSaved:
+  ///   Filter by saved status
   ///
   /// * [bool] isTrashed:
+  ///   Include trashed memories
   ///
   /// * [MemorySearchOrder] order:
+  ///   Sort order
   ///
   /// * [int] size:
   ///   Number of memories to return
   ///
   /// * [MemoryType] type:
+  ///   Memory type
   Future<List<MemoryResponseDto>?> searchMemories({ DateTime? for_, bool? isSaved, bool? isTrashed, MemorySearchOrder? order, int? size, MemoryType? type, }) async {
     final response = await searchMemoriesWithHttpInfo( for_: for_, isSaved: isSaved, isTrashed: isTrashed, order: order, size: size, type: type, );
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/notifications_api.dart

@@ -179,12 +179,16 @@ class NotificationsApi {
   /// Parameters:
   ///
   /// * [String] id:
+  ///   Filter by notification ID
   ///
   /// * [NotificationLevel] level:
+  ///   Filter by notification level
   ///
   /// * [NotificationType] type:
+  ///   Filter by notification type
   ///
   /// * [bool] unread:
+  ///   Filter by unread status
   Future<Response> getNotificationsWithHttpInfo({ String? id, NotificationLevel? level, NotificationType? type, bool? unread, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/notifications';
@@ -230,12 +234,16 @@ class NotificationsApi {
   /// Parameters:
   ///
   /// * [String] id:
+  ///   Filter by notification ID
   ///
   /// * [NotificationLevel] level:
+  ///   Filter by notification level
   ///
   /// * [NotificationType] type:
+  ///   Filter by notification type
   ///
   /// * [bool] unread:
+  ///   Filter by unread status
   Future<List<NotificationDto>?> getNotifications({ String? id, NotificationLevel? level, NotificationType? type, bool? unread, }) async {
     final response = await getNotificationsWithHttpInfo( id: id, level: level, type: type, unread: unread, );
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/partners_api.dart

@@ -138,6 +138,7 @@ class PartnersApi {
   /// Parameters:
   ///
   /// * [PartnerDirection] direction (required):
+  ///   Partner direction
   Future<Response> getPartnersWithHttpInfo(PartnerDirection direction,) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/partners';
@@ -172,6 +173,7 @@ class PartnersApi {
   /// Parameters:
   ///
   /// * [PartnerDirection] direction (required):
+  ///   Partner direction
   Future<List<PartnerResponseDto>?> getPartners(PartnerDirection direction,) async {
     final response = await getPartnersWithHttpInfo(direction,);
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/people_api.dart

@@ -178,8 +178,10 @@ class PeopleApi {
   /// Parameters:
   ///
   /// * [String] closestAssetId:
+  ///   Closest asset ID for similarity search
   ///
   /// * [String] closestPersonId:
+  ///   Closest person ID for similarity search
   ///
   /// * [num] page:
   ///   Page number for pagination
@@ -188,6 +190,7 @@ class PeopleApi {
   ///   Number of items per page
   ///
   /// * [bool] withHidden:
+  ///   Include hidden people
   Future<Response> getAllPeopleWithHttpInfo({ String? closestAssetId, String? closestPersonId, num? page, num? size, bool? withHidden, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/people';
@@ -236,8 +239,10 @@ class PeopleApi {
   /// Parameters:
   ///
   /// * [String] closestAssetId:
+  ///   Closest asset ID for similarity search
   ///
   /// * [String] closestPersonId:
+  ///   Closest person ID for similarity search
   ///
   /// * [num] page:
   ///   Page number for pagination
@@ -246,6 +251,7 @@ class PeopleApi {
   ///   Number of items per page
   ///
   /// * [bool] withHidden:
+  ///   Include hidden people
   Future<PeopleResponseDto?> getAllPeople({ String? closestAssetId, String? closestPersonId, num? page, num? size, bool? withHidden, }) async {
     final response = await getAllPeopleWithHttpInfo( closestAssetId: closestAssetId, closestPersonId: closestPersonId, page: page, size: size, withHidden: withHidden, );
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/queues_api.dart

@@ -25,6 +25,7 @@ class QueuesApi {
   /// Parameters:
   ///
   /// * [QueueName] name (required):
+  ///   Queue name
   ///
   /// * [QueueDeleteDto] queueDeleteDto (required):
   Future<Response> emptyQueueWithHttpInfo(QueueName name, QueueDeleteDto queueDeleteDto,) async {
@@ -60,6 +61,7 @@ class QueuesApi {
   /// Parameters:
   ///
   /// * [QueueName] name (required):
+  ///   Queue name
   ///
   /// * [QueueDeleteDto] queueDeleteDto (required):
   Future<void> emptyQueue(QueueName name, QueueDeleteDto queueDeleteDto,) async {
@@ -78,6 +80,7 @@ class QueuesApi {
   /// Parameters:
   ///
   /// * [QueueName] name (required):
+  ///   Queue name
   Future<Response> getQueueWithHttpInfo(QueueName name,) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/queues/{name}'
@@ -111,6 +114,7 @@ class QueuesApi {
   /// Parameters:
   ///
   /// * [QueueName] name (required):
+  ///   Queue name
   Future<QueueResponseDto?> getQueue(QueueName name,) async {
     final response = await getQueueWithHttpInfo(name,);
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -135,8 +139,10 @@ class QueuesApi {
   /// Parameters:
   ///
   /// * [QueueName] name (required):
+  ///   Queue name
   ///
   /// * [List<QueueJobStatus>] status:
+  ///   Filter jobs by status
   Future<Response> getQueueJobsWithHttpInfo(QueueName name, { List<QueueJobStatus>? status, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/queues/{name}/jobs'
@@ -174,8 +180,10 @@ class QueuesApi {
   /// Parameters:
   ///
   /// * [QueueName] name (required):
+  ///   Queue name
   ///
   /// * [List<QueueJobStatus>] status:
+  ///   Filter jobs by status
   Future<List<QueueJobResponseDto>?> getQueueJobs(QueueName name, { List<QueueJobStatus>? status, }) async {
     final response = await getQueueJobsWithHttpInfo(name,  status: status, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -254,6 +262,7 @@ class QueuesApi {
   /// Parameters:
   ///
   /// * [QueueName] name (required):
+  ///   Queue name
   ///
   /// * [QueueUpdateDto] queueUpdateDto (required):
   Future<Response> updateQueueWithHttpInfo(QueueName name, QueueUpdateDto queueUpdateDto,) async {
@@ -289,6 +298,7 @@ class QueuesApi {
   /// Parameters:
   ///
   /// * [QueueName] name (required):
+  ///   Queue name
   ///
   /// * [QueueUpdateDto] queueUpdateDto (required):
   Future<QueueResponseDto?> updateQueue(QueueName name, QueueUpdateDto queueUpdateDto,) async {

mobile/openapi/lib/api/search_api.dart

@@ -127,18 +127,25 @@ class SearchApi {
   /// Parameters:
   ///
   /// * [SearchSuggestionType] type (required):
+  ///   Suggestion type
   ///
   /// * [String] country:
+  ///   Filter by country
   ///
   /// * [bool] includeNull:
+  ///   Include null values in suggestions
   ///
   /// * [String] lensModel:
+  ///   Filter by lens model
   ///
   /// * [String] make:
+  ///   Filter by camera make
   ///
   /// * [String] model:
+  ///   Filter by camera model
   ///
   /// * [String] state:
+  ///   Filter by state/province
   Future<Response> getSearchSuggestionsWithHttpInfo(SearchSuggestionType type, { String? country, bool? includeNull, String? lensModel, String? make, String? model, String? state, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/search/suggestions';
@@ -191,18 +198,25 @@ class SearchApi {
   /// Parameters:
   ///
   /// * [SearchSuggestionType] type (required):
+  ///   Suggestion type
   ///
   /// * [String] country:
+  ///   Filter by country
   ///
   /// * [bool] includeNull:
+  ///   Include null values in suggestions
   ///
   /// * [String] lensModel:
+  ///   Filter by lens model
   ///
   /// * [String] make:
+  ///   Filter by camera make
   ///
   /// * [String] model:
+  ///   Filter by camera model
   ///
   /// * [String] state:
+  ///   Filter by state/province
   Future<List<String>?> getSearchSuggestions(SearchSuggestionType type, { String? country, bool? includeNull, String? lensModel, String? make, String? model, String? state, }) async {
     final response = await getSearchSuggestionsWithHttpInfo(type,  country: country, includeNull: includeNull, lensModel: lensModel, make: make, model: model, state: state, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -342,68 +356,100 @@ class SearchApi {
   /// Parameters:
   ///
   /// * [List<String>] albumIds:
+  ///   Filter by album IDs
   ///
   /// * [String] city:
+  ///   Filter by city name
   ///
   /// * [String] country:
+  ///   Filter by country name
   ///
   /// * [DateTime] createdAfter:
+  ///   Filter by creation date (after)
   ///
   /// * [DateTime] createdBefore:
+  ///   Filter by creation date (before)
   ///
   /// * [String] deviceId:
+  ///   Device ID to filter by
   ///
   /// * [bool] isEncoded:
+  ///   Filter by encoded status
   ///
   /// * [bool] isFavorite:
+  ///   Filter by favorite status
   ///
   /// * [bool] isMotion:
+  ///   Filter by motion photo status
   ///
   /// * [bool] isNotInAlbum:
+  ///   Filter assets not in any album
   ///
   /// * [bool] isOffline:
+  ///   Filter by offline status
   ///
   /// * [String] lensModel:
+  ///   Filter by lens model
   ///
   /// * [String] libraryId:
+  ///   Library ID to filter by
   ///
   /// * [String] make:
+  ///   Filter by camera make
   ///
   /// * [int] minFileSize:
+  ///   Minimum file size in bytes
   ///
   /// * [String] model:
+  ///   Filter by camera model
   ///
   /// * [String] ocr:
+  ///   Filter by OCR text content
   ///
   /// * [List<String>] personIds:
+  ///   Filter by person IDs
   ///
   /// * [num] rating:
+  ///   Filter by rating
   ///
   /// * [num] size:
+  ///   Number of results to return
   ///
   /// * [String] state:
+  ///   Filter by state/province name
   ///
   /// * [List<String>] tagIds:
+  ///   Filter by tag IDs
   ///
   /// * [DateTime] takenAfter:
+  ///   Filter by taken date (after)
   ///
   /// * [DateTime] takenBefore:
+  ///   Filter by taken date (before)
   ///
   /// * [DateTime] trashedAfter:
+  ///   Filter by trash date (after)
   ///
   /// * [DateTime] trashedBefore:
+  ///   Filter by trash date (before)
   ///
   /// * [AssetTypeEnum] type:
+  ///   Asset type filter
   ///
   /// * [DateTime] updatedAfter:
+  ///   Filter by update date (after)
   ///
   /// * [DateTime] updatedBefore:
+  ///   Filter by update date (before)
   ///
   /// * [AssetVisibility] visibility:
+  ///   Filter by visibility
   ///
   /// * [bool] withDeleted:
+  ///   Include deleted assets
   ///
   /// * [bool] withExif:
+  ///   Include EXIF data in response
   Future<Response> searchLargeAssetsWithHttpInfo({ List<String>? albumIds, String? city, String? country, DateTime? createdAfter, DateTime? createdBefore, String? deviceId, bool? isEncoded, bool? isFavorite, bool? isMotion, bool? isNotInAlbum, bool? isOffline, String? lensModel, String? libraryId, String? make, int? minFileSize, String? model, String? ocr, List<String>? personIds, num? rating, num? size, String? state, List<String>? tagIds, DateTime? takenAfter, DateTime? takenBefore, DateTime? trashedAfter, DateTime? trashedBefore, AssetTypeEnum? type, DateTime? updatedAfter, DateTime? updatedBefore, AssetVisibility? visibility, bool? withDeleted, bool? withExif, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/search/large-assets';
@@ -533,68 +579,100 @@ class SearchApi {
   /// Parameters:
   ///
   /// * [List<String>] albumIds:
+  ///   Filter by album IDs
   ///
   /// * [String] city:
+  ///   Filter by city name
   ///
   /// * [String] country:
+  ///   Filter by country name
   ///
   /// * [DateTime] createdAfter:
+  ///   Filter by creation date (after)
   ///
   /// * [DateTime] createdBefore:
+  ///   Filter by creation date (before)
   ///
   /// * [String] deviceId:
+  ///   Device ID to filter by
   ///
   /// * [bool] isEncoded:
+  ///   Filter by encoded status
   ///
   /// * [bool] isFavorite:
+  ///   Filter by favorite status
   ///
   /// * [bool] isMotion:
+  ///   Filter by motion photo status
   ///
   /// * [bool] isNotInAlbum:
+  ///   Filter assets not in any album
   ///
   /// * [bool] isOffline:
+  ///   Filter by offline status
   ///
   /// * [String] lensModel:
+  ///   Filter by lens model
   ///
   /// * [String] libraryId:
+  ///   Library ID to filter by
   ///
   /// * [String] make:
+  ///   Filter by camera make
   ///
   /// * [int] minFileSize:
+  ///   Minimum file size in bytes
   ///
   /// * [String] model:
+  ///   Filter by camera model
   ///
   /// * [String] ocr:
+  ///   Filter by OCR text content
   ///
   /// * [List<String>] personIds:
+  ///   Filter by person IDs
   ///
   /// * [num] rating:
+  ///   Filter by rating
   ///
   /// * [num] size:
+  ///   Number of results to return
   ///
   /// * [String] state:
+  ///   Filter by state/province name
   ///
   /// * [List<String>] tagIds:
+  ///   Filter by tag IDs
   ///
   /// * [DateTime] takenAfter:
+  ///   Filter by taken date (after)
   ///
   /// * [DateTime] takenBefore:
+  ///   Filter by taken date (before)
   ///
   /// * [DateTime] trashedAfter:
+  ///   Filter by trash date (after)
   ///
   /// * [DateTime] trashedBefore:
+  ///   Filter by trash date (before)
   ///
   /// * [AssetTypeEnum] type:
+  ///   Asset type filter
   ///
   /// * [DateTime] updatedAfter:
+  ///   Filter by update date (after)
   ///
   /// * [DateTime] updatedBefore:
+  ///   Filter by update date (before)
   ///
   /// * [AssetVisibility] visibility:
+  ///   Filter by visibility
   ///
   /// * [bool] withDeleted:
+  ///   Include deleted assets
   ///
   /// * [bool] withExif:
+  ///   Include EXIF data in response
   Future<List<AssetResponseDto>?> searchLargeAssets({ List<String>? albumIds, String? city, String? country, DateTime? createdAfter, DateTime? createdBefore, String? deviceId, bool? isEncoded, bool? isFavorite, bool? isMotion, bool? isNotInAlbum, bool? isOffline, String? lensModel, String? libraryId, String? make, int? minFileSize, String? model, String? ocr, List<String>? personIds, num? rating, num? size, String? state, List<String>? tagIds, DateTime? takenAfter, DateTime? takenBefore, DateTime? trashedAfter, DateTime? trashedBefore, AssetTypeEnum? type, DateTime? updatedAfter, DateTime? updatedBefore, AssetVisibility? visibility, bool? withDeleted, bool? withExif, }) async {
     final response = await searchLargeAssetsWithHttpInfo( albumIds: albumIds, city: city, country: country, createdAfter: createdAfter, createdBefore: createdBefore, deviceId: deviceId, isEncoded: isEncoded, isFavorite: isFavorite, isMotion: isMotion, isNotInAlbum: isNotInAlbum, isOffline: isOffline, lensModel: lensModel, libraryId: libraryId, make: make, minFileSize: minFileSize, model: model, ocr: ocr, personIds: personIds, rating: rating, size: size, state: state, tagIds: tagIds, takenAfter: takenAfter, takenBefore: takenBefore, trashedAfter: trashedAfter, trashedBefore: trashedBefore, type: type, updatedAfter: updatedAfter, updatedBefore: updatedBefore, visibility: visibility, withDeleted: withDeleted, withExif: withExif, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -622,8 +700,10 @@ class SearchApi {
   /// Parameters:
   ///
   /// * [String] name (required):
+  ///   Person name to search for
   ///
   /// * [bool] withHidden:
+  ///   Include hidden people
   Future<Response> searchPersonWithHttpInfo(String name, { bool? withHidden, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/search/person';
@@ -661,8 +741,10 @@ class SearchApi {
   /// Parameters:
   ///
   /// * [String] name (required):
+  ///   Person name to search for
   ///
   /// * [bool] withHidden:
+  ///   Include hidden people
   Future<List<PersonResponseDto>?> searchPerson(String name, { bool? withHidden, }) async {
     final response = await searchPersonWithHttpInfo(name,  withHidden: withHidden, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -690,6 +772,7 @@ class SearchApi {
   /// Parameters:
   ///
   /// * [String] name (required):
+  ///   Place name to search for
   Future<Response> searchPlacesWithHttpInfo(String name,) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/search/places';
@@ -724,6 +807,7 @@ class SearchApi {
   /// Parameters:
   ///
   /// * [String] name (required):
+  ///   Place name to search for
   Future<List<PlacesResponseDto>?> searchPlaces(String name,) async {
     final response = await searchPlacesWithHttpInfo(name,);
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/shared_links_api.dart

@@ -160,8 +160,10 @@ class SharedLinksApi {
   /// Parameters:
   ///
   /// * [String] albumId:
+  ///   Filter by album ID
   ///
   /// * [String] id:
+  ///   Filter by shared link ID
   Future<Response> getAllSharedLinksWithHttpInfo({ String? albumId, String? id, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/shared-links';
@@ -201,8 +203,10 @@ class SharedLinksApi {
   /// Parameters:
   ///
   /// * [String] albumId:
+  ///   Filter by album ID
   ///
   /// * [String] id:
+  ///   Filter by shared link ID
   Future<List<SharedLinkResponseDto>?> getAllSharedLinks({ String? albumId, String? id, }) async {
     final response = await getAllSharedLinksWithHttpInfo( albumId: albumId, id: id, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -232,10 +236,12 @@ class SharedLinksApi {
   /// * [String] key:
   ///
   /// * [String] password:
+  ///   Link password
   ///
   /// * [String] slug:
   ///
   /// * [String] token:
+  ///   Access token
   Future<Response> getMySharedLinkWithHttpInfo({ String? key, String? password, String? slug, String? token, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/shared-links/me';
@@ -283,10 +289,12 @@ class SharedLinksApi {
   /// * [String] key:
   ///
   /// * [String] password:
+  ///   Link password
   ///
   /// * [String] slug:
   ///
   /// * [String] token:
+  ///   Access token
   Future<SharedLinkResponseDto?> getMySharedLink({ String? key, String? password, String? slug, String? token, }) async {
     final response = await getMySharedLinkWithHttpInfo( key: key, password: password, slug: slug, token: token, );
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/stacks_api.dart

@@ -289,6 +289,7 @@ class StacksApi {
   /// Parameters:
   ///
   /// * [String] primaryAssetId:
+  ///   Filter by primary asset ID
   Future<Response> searchStacksWithHttpInfo({ String? primaryAssetId, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/stacks';
@@ -325,6 +326,7 @@ class StacksApi {
   /// Parameters:
   ///
   /// * [String] primaryAssetId:
+  ///   Filter by primary asset ID
   Future<List<StackResponseDto>?> searchStacks({ String? primaryAssetId, }) async {
     final response = await searchStacksWithHttpInfo( primaryAssetId: primaryAssetId, );
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/users_admin_api.dart

@@ -318,10 +318,13 @@ class UsersAdminApi {
   /// * [String] id (required):
   ///
   /// * [bool] isFavorite:
+  ///   Filter by favorite status
   ///
   /// * [bool] isTrashed:
+  ///   Filter by trash status
   ///
   /// * [AssetVisibility] visibility:
+  ///   Filter by visibility
   Future<Response> getUserStatisticsAdminWithHttpInfo(String id, { bool? isFavorite, bool? isTrashed, AssetVisibility? visibility, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/admin/users/{id}/statistics'
@@ -367,10 +370,13 @@ class UsersAdminApi {
   /// * [String] id (required):
   ///
   /// * [bool] isFavorite:
+  ///   Filter by favorite status
   ///
   /// * [bool] isTrashed:
+  ///   Filter by trash status
   ///
   /// * [AssetVisibility] visibility:
+  ///   Filter by visibility
   Future<AssetStatsResponseDto?> getUserStatisticsAdmin(String id, { bool? isFavorite, bool? isTrashed, AssetVisibility? visibility, }) async {
     final response = await getUserStatisticsAdminWithHttpInfo(id,  isFavorite: isFavorite, isTrashed: isTrashed, visibility: visibility, );
     if (response.statusCode >= HttpStatus.badRequest) {
@@ -452,8 +458,10 @@ class UsersAdminApi {
   /// Parameters:
   ///
   /// * [String] id:
+  ///   User ID filter
   ///
   /// * [bool] withDeleted:
+  ///   Include deleted users
   Future<Response> searchUsersAdminWithHttpInfo({ String? id, bool? withDeleted, }) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/admin/users';
@@ -493,8 +501,10 @@ class UsersAdminApi {
   /// Parameters:
   ///
   /// * [String] id:
+  ///   User ID filter
   ///
   /// * [bool] withDeleted:
+  ///   Include deleted users
   Future<List<UserAdminResponseDto>?> searchUsersAdmin({ String? id, bool? withDeleted, }) async {
     final response = await searchUsersAdminWithHttpInfo( id: id, withDeleted: withDeleted, );
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/api/users_api.dart

@@ -25,6 +25,7 @@ class UsersApi {
   /// Parameters:
   ///
   /// * [MultipartFile] file (required):
+  ///   Profile image file
   Future<Response> createProfileImageWithHttpInfo(MultipartFile file,) async {
     // ignore: prefer_const_declarations
     final apiPath = r'/users/profile-image';
@@ -67,6 +68,7 @@ class UsersApi {
   /// Parameters:
   ///
   /// * [MultipartFile] file (required):
+  ///   Profile image file
   Future<CreateProfileImageResponseDto?> createProfileImage(MultipartFile file,) async {
     final response = await createProfileImageWithHttpInfo(file,);
     if (response.statusCode >= HttpStatus.badRequest) {

mobile/openapi/lib/model/activity_create_dto.dart

@@ -19,8 +19,10 @@ class ActivityCreateDto {
     required this.type,
   });
 
+  /// Album ID
   String albumId;
 
+  /// Asset ID (if activity is for an asset)
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -29,6 +31,7 @@ class ActivityCreateDto {
   ///
   String? assetId;
 
+  /// Comment text (required if type is comment)
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -37,6 +40,7 @@ class ActivityCreateDto {
   ///
   String? comment;
 
+  /// Activity type (like or comment)
   ReactionType type;
 
   @override

mobile/openapi/lib/model/activity_response_dto.dart

@@ -21,14 +21,19 @@ class ActivityResponseDto {
     required this.user,
   });
 
+  /// Asset ID (if activity is for an asset)
   String? assetId;
 
+  /// Comment text (for comment activities)
   String? comment;
 
+  /// Creation date
   DateTime createdAt;
 
+  /// Activity ID
   String id;
 
+  /// Activity type
   ReactionType type;
 
   UserResponseDto user;

mobile/openapi/lib/model/activity_statistics_response_dto.dart

@@ -17,8 +17,10 @@ class ActivityStatisticsResponseDto {
     required this.likes,
   });
 
+  /// Number of comments
   int comments;
 
+  /// Number of likes
   int likes;
 
   @override

mobile/openapi/lib/model/add_users_dto.dart

@@ -16,6 +16,7 @@ class AddUsersDto {
     this.albumUsers = const [],
   });
 
+  /// Album users to add
   List<AlbumUserAddDto> albumUsers;
 
   @override

mobile/openapi/lib/model/admin_onboarding_update_dto.dart

@@ -16,6 +16,7 @@ class AdminOnboardingUpdateDto {
     required this.isOnboarded,
   });
 
+  /// Is admin onboarded
   bool isOnboarded;
 
   @override

mobile/openapi/lib/model/album_response_dto.dart

@@ -34,22 +34,28 @@ class AlbumResponseDto {
     required this.updatedAt,
   });
 
+  /// Album name
   String albumName;
 
+  /// Thumbnail asset ID
   String? albumThumbnailAssetId;
 
   List<AlbumUserResponseDto> albumUsers;
 
+  /// Number of assets
   int assetCount;
 
   List<AssetResponseDto> assets;
 
   List<ContributorCountResponseDto> contributorCounts;
 
+  /// Creation date
   DateTime createdAt;
 
+  /// Album description
   String description;
 
+  /// End date (latest asset)
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -58,12 +64,16 @@ class AlbumResponseDto {
   ///
   DateTime? endDate;
 
+  /// Has shared link
   bool hasSharedLink;
 
+  /// Album ID
   String id;
 
+  /// Activity feed enabled
   bool isActivityEnabled;
 
+  /// Last modified asset timestamp
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -72,6 +82,7 @@ class AlbumResponseDto {
   ///
   DateTime? lastModifiedAssetTimestamp;
 
+  /// Asset sort order
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -82,10 +93,13 @@ class AlbumResponseDto {
 
   UserResponseDto owner;
 
+  /// Owner user ID
   String ownerId;
 
+  /// Is shared album
   bool shared;
 
+  /// Start date (earliest asset)
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -94,6 +108,7 @@ class AlbumResponseDto {
   ///
   DateTime? startDate;
 
+  /// Last update date
   DateTime updatedAt;
 
   @override

mobile/openapi/lib/model/album_statistics_response_dto.dart

@@ -18,10 +18,13 @@ class AlbumStatisticsResponseDto {
     required this.shared,
   });
 
+  /// Number of non-shared albums
   int notShared;
 
+  /// Number of owned albums
   int owned;
 
+  /// Number of shared albums
   int shared;
 
   @override

mobile/openapi/lib/model/album_user_add_dto.dart

@@ -17,8 +17,10 @@ class AlbumUserAddDto {
     required this.userId,
   });
 
+  /// Album user role
   AlbumUserRole role;
 
+  /// User ID
   String userId;
 
   @override

mobile/openapi/lib/model/album_user_create_dto.dart

@@ -17,8 +17,10 @@ class AlbumUserCreateDto {
     required this.userId,
   });
 
+  /// Album user role
   AlbumUserRole role;
 
+  /// User ID
   String userId;
 
   @override

mobile/openapi/lib/model/album_user_response_dto.dart

@@ -17,6 +17,7 @@ class AlbumUserResponseDto {
     required this.user,
   });
 
+  /// Album user role
   AlbumUserRole role;
 
   UserResponseDto user;

mobile/openapi/lib/model/album_user_role.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Album user role
 class AlbumUserRole {
   /// Instantiate a new enum with the provided [value].
   const AlbumUserRole._(this.value);

mobile/openapi/lib/model/albums_add_assets_dto.dart

@@ -17,8 +17,10 @@ class AlbumsAddAssetsDto {
     this.assetIds = const [],
   });
 
+  /// Album IDs
   List<String> albumIds;
 
+  /// Asset IDs
   List<String> assetIds;
 
   @override

mobile/openapi/lib/model/albums_add_assets_response_dto.dart

@@ -17,6 +17,7 @@ class AlbumsAddAssetsResponseDto {
     required this.success,
   });
 
+  /// Error reason
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -25,6 +26,7 @@ class AlbumsAddAssetsResponseDto {
   ///
   BulkIdErrorReason? error;
 
+  /// Operation success
   bool success;
 
   @override

mobile/openapi/lib/model/albums_response.dart

@@ -16,6 +16,7 @@ class AlbumsResponse {
     this.defaultAssetOrder = AssetOrder.desc,
   });
 
+  /// Default asset order for albums
   AssetOrder defaultAssetOrder;
 
   @override

mobile/openapi/lib/model/albums_update.dart

@@ -16,6 +16,7 @@ class AlbumsUpdate {
     this.defaultAssetOrder,
   });
 
+  /// Default asset order for albums
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/api_key_create_dto.dart

@@ -17,6 +17,7 @@ class APIKeyCreateDto {
     this.permissions = const [],
   });
 
+  /// API key name
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -25,6 +26,7 @@ class APIKeyCreateDto {
   ///
   String? name;
 
+  /// List of permissions
   List<Permission> permissions;
 
   @override

mobile/openapi/lib/model/api_key_create_response_dto.dart

@@ -19,6 +19,7 @@ class APIKeyCreateResponseDto {
 
   APIKeyResponseDto apiKey;
 
+  /// API key secret (only shown once)
   String secret;
 
   @override

mobile/openapi/lib/model/api_key_response_dto.dart

@@ -20,14 +20,19 @@ class APIKeyResponseDto {
     required this.updatedAt,
   });
 
+  /// Creation date
   DateTime createdAt;
 
+  /// API key ID
   String id;
 
+  /// API key name
   String name;
 
+  /// List of permissions
   List<Permission> permissions;
 
+  /// Last update date
   DateTime updatedAt;
 
   @override

mobile/openapi/lib/model/api_key_update_dto.dart

@@ -17,6 +17,7 @@ class APIKeyUpdateDto {
     this.permissions = const [],
   });
 
+  /// API key name
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -25,6 +26,7 @@ class APIKeyUpdateDto {
   ///
   String? name;
 
+  /// List of permissions
   List<Permission> permissions;
 
   @override

mobile/openapi/lib/model/asset_bulk_delete_dto.dart

@@ -17,6 +17,7 @@ class AssetBulkDeleteDto {
     this.ids = const [],
   });
 
+  /// Force delete even if in use
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -25,6 +26,7 @@ class AssetBulkDeleteDto {
   ///
   bool? force;
 
+  /// IDs to process
   List<String> ids;
 
   @override

mobile/openapi/lib/model/asset_bulk_update_dto.dart

@@ -26,6 +26,7 @@ class AssetBulkUpdateDto {
     this.visibility,
   });
 
+  /// Original date and time
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -34,6 +35,7 @@ class AssetBulkUpdateDto {
   ///
   String? dateTimeOriginal;
 
+  /// Relative time offset in seconds
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -42,6 +44,7 @@ class AssetBulkUpdateDto {
   ///
   num? dateTimeRelative;
 
+  /// Asset description
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -50,10 +53,13 @@ class AssetBulkUpdateDto {
   ///
   String? description;
 
+  /// Duplicate asset ID
   String? duplicateId;
 
+  /// Asset IDs to update
   List<String> ids;
 
+  /// Mark as favorite
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -62,6 +68,7 @@ class AssetBulkUpdateDto {
   ///
   bool? isFavorite;
 
+  /// Latitude coordinate
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -70,6 +77,7 @@ class AssetBulkUpdateDto {
   ///
   num? latitude;
 
+  /// Longitude coordinate
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -78,6 +86,8 @@ class AssetBulkUpdateDto {
   ///
   num? longitude;
 
+  /// Rating
+  ///
   /// Minimum value: -1
   /// Maximum value: 5
   ///
@@ -88,6 +98,7 @@ class AssetBulkUpdateDto {
   ///
   num? rating;
 
+  /// Time zone (IANA timezone)
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -96,6 +107,7 @@ class AssetBulkUpdateDto {
   ///
   String? timeZone;
 
+  /// Asset visibility
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/asset_bulk_upload_check_dto.dart

@@ -16,6 +16,7 @@ class AssetBulkUploadCheckDto {
     this.assets = const [],
   });
 
+  /// Assets to check
   List<AssetBulkUploadCheckItem> assets;
 
   @override

mobile/openapi/lib/model/asset_bulk_upload_check_item.dart

@@ -17,9 +17,10 @@ class AssetBulkUploadCheckItem {
     required this.id,
   });
 
-  /// base64 or hex encoded sha1 hash
+  /// Base64 or hex encoded SHA1 hash
   String checksum;
 
+  /// Asset ID
   String id;
 
   @override

mobile/openapi/lib/model/asset_bulk_upload_check_response_dto.dart

@@ -16,6 +16,7 @@ class AssetBulkUploadCheckResponseDto {
     this.results = const [],
   });
 
+  /// Upload check results
   List<AssetBulkUploadCheckResult> results;
 
   @override

mobile/openapi/lib/model/asset_bulk_upload_check_result.dart

@@ -20,8 +20,10 @@ class AssetBulkUploadCheckResult {
     this.reason,
   });
 
+  /// Upload action
   AssetBulkUploadCheckResultActionEnum action;
 
+  /// Existing asset ID if duplicate
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -30,8 +32,10 @@ class AssetBulkUploadCheckResult {
   ///
   String? assetId;
 
+  /// Asset ID
   String id;
 
+  /// Whether existing asset is trashed
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -40,6 +44,7 @@ class AssetBulkUploadCheckResult {
   ///
   bool? isTrashed;
 
+  /// Rejection reason if rejected
   AssetBulkUploadCheckResultReasonEnum? reason;
 
   @override
@@ -150,7 +155,7 @@ class AssetBulkUploadCheckResult {
   };
 }
 
-
+/// Upload action
 class AssetBulkUploadCheckResultActionEnum {
   /// Instantiate a new enum with the provided [value].
   const AssetBulkUploadCheckResultActionEnum._(this.value);
@@ -224,7 +229,7 @@ class AssetBulkUploadCheckResultActionEnumTypeTransformer {
 }
 
 
-
+/// Rejection reason if rejected
 class AssetBulkUploadCheckResultReasonEnum {
   /// Instantiate a new enum with the provided [value].
   const AssetBulkUploadCheckResultReasonEnum._(this.value);

mobile/openapi/lib/model/asset_copy_dto.dart

@@ -22,18 +22,25 @@ class AssetCopyDto {
     required this.targetId,
   });
 
+  /// Copy album associations
   bool albums;
 
+  /// Copy favorite status
   bool favorite;
 
+  /// Copy shared links
   bool sharedLinks;
 
+  /// Copy sidecar file
   bool sidecar;
 
+  /// Source asset ID
   String sourceId;
 
+  /// Copy stack association
   bool stack;
 
+  /// Target asset ID
   String targetId;
 
   @override

mobile/openapi/lib/model/asset_delta_sync_dto.dart

@@ -17,8 +17,10 @@ class AssetDeltaSyncDto {
     this.userIds = const [],
   });
 
+  /// Sync assets updated after this date
   DateTime updatedAfter;
 
+  /// User IDs to sync
   List<String> userIds;
 
   @override

mobile/openapi/lib/model/asset_delta_sync_response_dto.dart

@@ -18,10 +18,13 @@ class AssetDeltaSyncResponseDto {
     this.upserted = const [],
   });
 
+  /// Deleted asset IDs
   List<String> deleted;
 
+  /// Whether full sync is needed
   bool needsFullSync;
 
+  /// Upserted assets
   List<AssetResponseDto> upserted;
 
   @override

mobile/openapi/lib/model/asset_edit_action.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Type of edit action to perform
 class AssetEditAction {
   /// Instantiate a new enum with the provided [value].
   const AssetEditAction._(this.value);

mobile/openapi/lib/model/asset_edit_action_crop.dart

@@ -17,6 +17,7 @@ class AssetEditActionCrop {
     required this.parameters,
   });
 
+  /// Type of edit action to perform
   AssetEditAction action;
 
   CropParameters parameters;

mobile/openapi/lib/model/asset_edit_action_list_dto.dart

@@ -16,7 +16,7 @@ class AssetEditActionListDto {
     this.edits = const [],
   });
 
-  /// list of edits
+  /// List of edit actions to apply (crop, rotate, or mirror)
   List<AssetEditActionListDtoEditsInner> edits;
 
   @override

mobile/openapi/lib/model/asset_edit_action_list_dto_edits_inner.dart

@@ -17,6 +17,7 @@ class AssetEditActionListDtoEditsInner {
     required this.parameters,
   });
 
+  /// Type of edit action to perform
   AssetEditAction action;
 
   MirrorParameters parameters;

mobile/openapi/lib/model/asset_edit_action_mirror.dart

@@ -17,6 +17,7 @@ class AssetEditActionMirror {
     required this.parameters,
   });
 
+  /// Type of edit action to perform
   AssetEditAction action;
 
   MirrorParameters parameters;

mobile/openapi/lib/model/asset_edit_action_rotate.dart

@@ -17,6 +17,7 @@ class AssetEditActionRotate {
     required this.parameters,
   });
 
+  /// Type of edit action to perform
   AssetEditAction action;
 
   RotateParameters parameters;

mobile/openapi/lib/model/asset_edits_dto.dart

@@ -17,9 +17,10 @@ class AssetEditsDto {
     this.edits = const [],
   });
 
+  /// Asset ID to apply edits to
   String assetId;
 
-  /// list of edits
+  /// List of edit actions to apply (crop, rotate, or mirror)
   List<AssetEditActionListDtoEditsInner> edits;
 
   @override

mobile/openapi/lib/model/asset_face_create_dto.dart

@@ -23,20 +23,28 @@ class AssetFaceCreateDto {
     required this.y,
   });
 
+  /// Asset ID
   String assetId;
 
+  /// Face bounding box height
   int height;
 
+  /// Image height in pixels
   int imageHeight;
 
+  /// Image width in pixels
   int imageWidth;
 
+  /// Person ID
   String personId;
 
+  /// Face bounding box width
   int width;
 
+  /// Face bounding box X coordinate
   int x;
 
+  /// Face bounding box Y coordinate
   int y;
 
   @override

mobile/openapi/lib/model/asset_face_delete_dto.dart

@@ -16,6 +16,7 @@ class AssetFaceDeleteDto {
     required this.force,
   });
 
+  /// Force delete even if person has other faces
   bool force;
 
   @override

mobile/openapi/lib/model/asset_face_response_dto.dart

@@ -24,22 +24,31 @@ class AssetFaceResponseDto {
     this.sourceType,
   });
 
+  /// Bounding box X1 coordinate
   int boundingBoxX1;
 
+  /// Bounding box X2 coordinate
   int boundingBoxX2;
 
+  /// Bounding box Y1 coordinate
   int boundingBoxY1;
 
+  /// Bounding box Y2 coordinate
   int boundingBoxY2;
 
+  /// Face ID
   String id;
 
+  /// Image height in pixels
   int imageHeight;
 
+  /// Image width in pixels
   int imageWidth;
 
+  /// Person associated with face
   PersonResponseDto? person;
 
+  /// Face detection source type
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/asset_face_update_dto.dart

@@ -16,6 +16,7 @@ class AssetFaceUpdateDto {
     this.data = const [],
   });
 
+  /// Face update items
   List<AssetFaceUpdateItem> data;
 
   @override

mobile/openapi/lib/model/asset_face_update_item.dart

@@ -17,8 +17,10 @@ class AssetFaceUpdateItem {
     required this.personId,
   });
 
+  /// Asset ID
   String assetId;
 
+  /// Person ID
   String personId;
 
   @override

mobile/openapi/lib/model/asset_face_without_person_response_dto.dart

@@ -23,20 +23,28 @@ class AssetFaceWithoutPersonResponseDto {
     this.sourceType,
   });
 
+  /// Bounding box X1 coordinate
   int boundingBoxX1;
 
+  /// Bounding box X2 coordinate
   int boundingBoxX2;
 
+  /// Bounding box Y1 coordinate
   int boundingBoxY1;
 
+  /// Bounding box Y2 coordinate
   int boundingBoxY2;
 
+  /// Face ID
   String id;
 
+  /// Image height in pixels
   int imageHeight;
 
+  /// Image width in pixels
   int imageWidth;
 
+  /// Face detection source type
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/asset_full_sync_dto.dart

@@ -19,6 +19,7 @@ class AssetFullSyncDto {
     this.userId,
   });
 
+  /// Last asset ID (pagination)
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -27,11 +28,15 @@ class AssetFullSyncDto {
   ///
   String? lastId;
 
+  /// Maximum number of assets to return
+  ///
   /// Minimum value: 1
   int limit;
 
+  /// Sync assets updated until this date
   DateTime updatedUntil;
 
+  /// Filter by user ID
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/asset_ids_dto.dart

@@ -16,6 +16,7 @@ class AssetIdsDto {
     this.assetIds = const [],
   });
 
+  /// Asset IDs
   List<String> assetIds;
 
   @override

mobile/openapi/lib/model/asset_ids_response_dto.dart

@@ -18,10 +18,13 @@ class AssetIdsResponseDto {
     required this.success,
   });
 
+  /// Asset ID
   String assetId;
 
+  /// Error reason if failed
   AssetIdsResponseDtoErrorEnum? error;
 
+  /// Whether operation succeeded
   bool success;
 
   @override
@@ -116,7 +119,7 @@ class AssetIdsResponseDto {
   };
 }
 
-
+/// Error reason if failed
 class AssetIdsResponseDtoErrorEnum {
   /// Instantiate a new enum with the provided [value].
   const AssetIdsResponseDtoErrorEnum._(this.value);

mobile/openapi/lib/model/asset_job_name.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Job name
 class AssetJobName {
   /// Instantiate a new enum with the provided [value].
   const AssetJobName._(this.value);

mobile/openapi/lib/model/asset_jobs_dto.dart

@@ -17,8 +17,10 @@ class AssetJobsDto {
     required this.name,
   });
 
+  /// Asset IDs
   List<String> assetIds;
 
+  /// Job name
   AssetJobName name;
 
   @override

mobile/openapi/lib/model/asset_media_response_dto.dart

@@ -17,8 +17,10 @@ class AssetMediaResponseDto {
     required this.status,
   });
 
+  /// Asset media ID
   String id;
 
+  /// Upload status
   AssetMediaStatus status;
 
   @override

mobile/openapi/lib/model/asset_media_status.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Upload status
 class AssetMediaStatus {
   /// Instantiate a new enum with the provided [value].
   const AssetMediaStatus._(this.value);

mobile/openapi/lib/model/asset_metadata_bulk_delete_dto.dart

@@ -16,6 +16,7 @@ class AssetMetadataBulkDeleteDto {
     this.items = const [],
   });
 
+  /// Metadata items to delete
   List<AssetMetadataBulkDeleteItemDto> items;
 
   @override

mobile/openapi/lib/model/asset_metadata_bulk_delete_item_dto.dart

@@ -17,8 +17,10 @@ class AssetMetadataBulkDeleteItemDto {
     required this.key,
   });
 
+  /// Asset ID
   String assetId;
 
+  /// Metadata key
   String key;
 
   @override

mobile/openapi/lib/model/asset_metadata_bulk_response_dto.dart

@@ -19,12 +19,16 @@ class AssetMetadataBulkResponseDto {
     required this.value,
   });
 
+  /// Asset ID
   String assetId;
 
+  /// Metadata key
   String key;
 
+  /// Last update date
   DateTime updatedAt;
 
+  /// Metadata value (object)
   Object value;
 
   @override

mobile/openapi/lib/model/asset_metadata_bulk_upsert_dto.dart

@@ -16,6 +16,7 @@ class AssetMetadataBulkUpsertDto {
     this.items = const [],
   });
 
+  /// Metadata items to upsert
   List<AssetMetadataBulkUpsertItemDto> items;
 
   @override

mobile/openapi/lib/model/asset_metadata_bulk_upsert_item_dto.dart

@@ -18,10 +18,13 @@ class AssetMetadataBulkUpsertItemDto {
     required this.value,
   });
 
+  /// Asset ID
   String assetId;
 
+  /// Metadata key
   String key;
 
+  /// Metadata value (object)
   Object value;
 
   @override

mobile/openapi/lib/model/asset_metadata_response_dto.dart

@@ -18,10 +18,13 @@ class AssetMetadataResponseDto {
     required this.value,
   });
 
+  /// Metadata key
   String key;
 
+  /// Last update date
   DateTime updatedAt;
 
+  /// Metadata value (object)
   Object value;
 
   @override

mobile/openapi/lib/model/asset_metadata_upsert_dto.dart

@@ -16,6 +16,7 @@ class AssetMetadataUpsertDto {
     this.items = const [],
   });
 
+  /// Metadata items to upsert
   List<AssetMetadataUpsertItemDto> items;
 
   @override

mobile/openapi/lib/model/asset_metadata_upsert_item_dto.dart

@@ -17,8 +17,10 @@ class AssetMetadataUpsertItemDto {
     required this.value,
   });
 
+  /// Metadata key
   String key;
 
+  /// Metadata value (object)
   Object value;
 
   @override

mobile/openapi/lib/model/asset_order.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Asset sort order
 class AssetOrder {
   /// Instantiate a new enum with the provided [value].
   const AssetOrder._(this.value);

mobile/openapi/lib/model/asset_response_dto.dart

@@ -50,18 +50,22 @@ class AssetResponseDto {
     required this.width,
   });
 
-  /// base64 encoded sha1 hash
+  /// Base64 encoded SHA1 hash
   String checksum;
 
   /// The UTC timestamp when the asset was originally uploaded to Immich.
   DateTime createdAt;
 
+  /// Device asset ID
   String deviceAssetId;
 
+  /// Device ID
   String deviceId;
 
+  /// Duplicate group ID
   String? duplicateId;
 
+  /// Video duration (for videos)
   String duration;
 
   ///
@@ -78,31 +82,43 @@ class AssetResponseDto {
   /// The UTC timestamp when the file was last modified on the filesystem. This reflects the last time the physical file was changed, which may be different from when the photo was originally taken.
   DateTime fileModifiedAt;
 
+  /// Whether asset has metadata
   bool hasMetadata;
 
+  /// Asset height
   num? height;
 
+  /// Asset ID
   String id;
 
+  /// Is archived
   bool isArchived;
 
+  /// Is edited
   bool isEdited;
 
+  /// Is favorite
   bool isFavorite;
 
+  /// Is offline
   bool isOffline;
 
+  /// Is trashed
   bool isTrashed;
 
+  /// Library ID
   String? libraryId;
 
+  /// Live photo video ID
   String? livePhotoVideoId;
 
   /// The local date and time when the photo/video was taken, derived from EXIF metadata. This represents the photographer's local time regardless of timezone, stored as a timezone-agnostic timestamp. Used for timeline grouping by \"local\" days and months.
   DateTime localDateTime;
 
+  /// Original file name
   String originalFileName;
 
+  /// Original MIME type
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -111,6 +127,7 @@ class AssetResponseDto {
   ///
   String? originalMimeType;
 
+  /// Original file path
   String originalPath;
 
   ///
@@ -121,10 +138,12 @@ class AssetResponseDto {
   ///
   UserResponseDto? owner;
 
+  /// Owner user ID
   String ownerId;
 
   List<PersonWithFacesResponseDto> people;
 
+  /// Is resized
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -137,8 +156,10 @@ class AssetResponseDto {
 
   List<TagResponseDto> tags;
 
+  /// Thumbhash for thumbnail generation
   String? thumbhash;
 
+  /// Asset type
   AssetTypeEnum type;
 
   List<AssetFaceWithoutPersonResponseDto> unassignedFaces;
@@ -146,8 +167,10 @@ class AssetResponseDto {
   /// The UTC timestamp when the asset record was last updated in the database. This is automatically maintained by the database and reflects when any field in the asset was last modified.
   DateTime updatedAt;
 
+  /// Asset visibility
   AssetVisibility visibility;
 
+  /// Asset width
   num? width;
 
   @override

mobile/openapi/lib/model/asset_stack_response_dto.dart

@@ -18,10 +18,13 @@ class AssetStackResponseDto {
     required this.primaryAssetId,
   });
 
+  /// Number of assets in stack
   int assetCount;
 
+  /// Stack ID
   String id;
 
+  /// Primary asset ID
   String primaryAssetId;
 
   @override

mobile/openapi/lib/model/asset_stats_response_dto.dart

@@ -18,10 +18,13 @@ class AssetStatsResponseDto {
     required this.videos,
   });
 
+  /// Number of images
   int images;
 
+  /// Total number of assets
   int total;
 
+  /// Number of videos
   int videos;
 
   @override

mobile/openapi/lib/model/asset_type_enum.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Asset type
 class AssetTypeEnum {
   /// Instantiate a new enum with the provided [value].
   const AssetTypeEnum._(this.value);

mobile/openapi/lib/model/asset_visibility.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Asset visibility
 class AssetVisibility {
   /// Instantiate a new enum with the provided [value].
   const AssetVisibility._(this.value);

mobile/openapi/lib/model/audio_codec.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Target audio codec
 class AudioCodec {
   /// Instantiate a new enum with the provided [value].
   const AudioCodec._(this.value);

mobile/openapi/lib/model/auth_status_response_dto.dart

@@ -20,6 +20,7 @@ class AuthStatusResponseDto {
     this.pinExpiresAt,
   });
 
+  /// Session expiration date
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -28,12 +29,16 @@ class AuthStatusResponseDto {
   ///
   String? expiresAt;
 
+  /// Is elevated session
   bool isElevated;
 
+  /// Has password set
   bool password;
 
+  /// Has PIN code set
   bool pinCode;
 
+  /// PIN expiration date
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/avatar_update.dart

@@ -16,6 +16,7 @@ class AvatarUpdate {
     this.color,
   });
 
+  /// Avatar color
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/bulk_id_error_reason.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Error reason
 class BulkIdErrorReason {
   /// Instantiate a new enum with the provided [value].
   const BulkIdErrorReason._(this.value);

mobile/openapi/lib/model/bulk_id_response_dto.dart

@@ -18,10 +18,13 @@ class BulkIdResponseDto {
     required this.success,
   });
 
+  /// Error reason if failed
   BulkIdResponseDtoErrorEnum? error;
 
+  /// ID
   String id;
 
+  /// Whether operation succeeded
   bool success;
 
   @override
@@ -116,7 +119,7 @@ class BulkIdResponseDto {
   };
 }
 
-
+/// Error reason if failed
 class BulkIdResponseDtoErrorEnum {
   /// Instantiate a new enum with the provided [value].
   const BulkIdResponseDtoErrorEnum._(this.value);

mobile/openapi/lib/model/bulk_ids_dto.dart

@@ -16,6 +16,7 @@ class BulkIdsDto {
     this.ids = const [],
   });
 
+  /// IDs to process
   List<String> ids;
 
   @override

mobile/openapi/lib/model/cast_response.dart

@@ -16,6 +16,7 @@ class CastResponse {
     this.gCastEnabled = false,
   });
 
+  /// Whether Google Cast is enabled
   bool gCastEnabled;
 
   @override

mobile/openapi/lib/model/cast_update.dart

@@ -16,6 +16,7 @@ class CastUpdate {
     this.gCastEnabled,
   });
 
+  /// Whether Google Cast is enabled
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/change_password_dto.dart

@@ -18,10 +18,13 @@ class ChangePasswordDto {
     required this.password,
   });
 
+  /// Invalidate all other sessions
   bool invalidateSessions;
 
+  /// New password (min 8 characters)
   String newPassword;
 
+  /// Current password
   String password;
 
   @override

mobile/openapi/lib/model/check_existing_assets_dto.dart

@@ -17,8 +17,10 @@ class CheckExistingAssetsDto {
     required this.deviceId,
   });
 
+  /// Device asset IDs to check
   List<String> deviceAssetIds;
 
+  /// Device ID
   String deviceId;
 
   @override

mobile/openapi/lib/model/check_existing_assets_response_dto.dart

@@ -16,6 +16,7 @@ class CheckExistingAssetsResponseDto {
     this.existingIds = const [],
   });
 
+  /// Existing asset IDs
   List<String> existingIds;
 
   @override

mobile/openapi/lib/model/clip_config.dart

@@ -17,8 +17,10 @@ class CLIPConfig {
     required this.modelName,
   });
 
+  /// Whether the task is enabled
   bool enabled;
 
+  /// Name of the model to use
   String modelName;
 
   @override

mobile/openapi/lib/model/colorspace.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Colorspace
 class Colorspace {
   /// Instantiate a new enum with the provided [value].
   const Colorspace._(this.value);

mobile/openapi/lib/model/contributor_count_response_dto.dart

@@ -17,8 +17,10 @@ class ContributorCountResponseDto {
     required this.userId,
   });
 
+  /// Number of assets contributed
   int assetCount;
 
+  /// User ID
   String userId;
 
   @override

mobile/openapi/lib/model/cq_mode.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// CQ mode
 class CQMode {
   /// Instantiate a new enum with the provided [value].
   const CQMode._(this.value);

mobile/openapi/lib/model/create_album_dto.dart

@@ -19,12 +19,16 @@ class CreateAlbumDto {
     this.description,
   });
 
+  /// Album name
   String albumName;
 
+  /// Album users
   List<AlbumUserCreateDto> albumUsers;
 
+  /// Initial asset IDs
   List<String> assetIds;
 
+  /// Album description
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/create_library_dto.dart

@@ -19,10 +19,13 @@ class CreateLibraryDto {
     required this.ownerId,
   });
 
+  /// Exclusion patterns (max 128)
   Set<String> exclusionPatterns;
 
+  /// Import paths (max 128)
   Set<String> importPaths;
 
+  /// Library name
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -31,6 +34,7 @@ class CreateLibraryDto {
   ///
   String? name;
 
+  /// Owner user ID
   String ownerId;
 
   @override

mobile/openapi/lib/model/create_profile_image_response_dto.dart

@@ -18,10 +18,13 @@ class CreateProfileImageResponseDto {
     required this.userId,
   });
 
+  /// Profile image change date
   DateTime profileChangedAt;
 
+  /// Profile image file path
   String profileImagePath;
 
+  /// User ID
   String userId;
 
   @override

mobile/openapi/lib/model/database_backup_config.dart

@@ -18,10 +18,14 @@ class DatabaseBackupConfig {
     required this.keepLastAmount,
   });
 
+  /// Cron expression
   String cronExpression;
 
+  /// Enabled
   bool enabled;
 
+  /// Keep last amount
+  ///
   /// Minimum value: 1
   num keepLastAmount;
 

mobile/openapi/lib/model/download_archive_info.dart

@@ -17,8 +17,10 @@ class DownloadArchiveInfo {
     required this.size,
   });
 
+  /// Asset IDs in this archive
   List<String> assetIds;
 
+  /// Archive size in bytes
   int size;
 
   @override

mobile/openapi/lib/model/download_info_dto.dart

@@ -19,6 +19,7 @@ class DownloadInfoDto {
     this.userId,
   });
 
+  /// Album ID to download
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -27,6 +28,8 @@ class DownloadInfoDto {
   ///
   String? albumId;
 
+  /// Archive size limit in bytes
+  ///
   /// Minimum value: 1
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
@@ -36,8 +39,10 @@ class DownloadInfoDto {
   ///
   int? archiveSize;
 
+  /// Asset IDs to download
   List<String> assetIds;
 
+  /// User ID to download assets from
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated