immichpy 1.6.5__py3-none-any.whl → 1.7.5__py3-none-any.whl

immichpy/client/generated/api/assets_api.py

@@ -5,7 +5,7 @@ Immich
 
 Immich API
 
-The version of the OpenAPI document: 2.4.1
+The version of the OpenAPI document: 2.5.2
 Generated by OpenAPI Generator (https://openapi-generator.tech)
 
 Do not edit the class manually.
@@ -28,12 +28,24 @@ from immichpy.client.generated.models.asset_bulk_upload_check_response_dto impor
     AssetBulkUploadCheckResponseDto,
 )
 from immichpy.client.generated.models.asset_copy_dto import AssetCopyDto
+from immichpy.client.generated.models.asset_edit_action_list_dto import (
+    AssetEditActionListDto,
+)
+from immichpy.client.generated.models.asset_edits_dto import AssetEditsDto
 from immichpy.client.generated.models.asset_jobs_dto import AssetJobsDto
 from immichpy.client.generated.models.asset_media_response_dto import (
     AssetMediaResponseDto,
 )
 from immichpy.client.generated.models.asset_media_size import AssetMediaSize
-from immichpy.client.generated.models.asset_metadata_key import AssetMetadataKey
+from immichpy.client.generated.models.asset_metadata_bulk_delete_dto import (
+    AssetMetadataBulkDeleteDto,
+)
+from immichpy.client.generated.models.asset_metadata_bulk_response_dto import (
+    AssetMetadataBulkResponseDto,
+)
+from immichpy.client.generated.models.asset_metadata_bulk_upsert_dto import (
+    AssetMetadataBulkUpsertDto,
+)
 from immichpy.client.generated.models.asset_metadata_response_dto import (
     AssetMetadataResponseDto,
 )
@@ -824,8 +836,8 @@ class AssetsApi:
     @validate_call
     async def delete_asset_metadata(
         self,
-        id: UUID,
-        key: AssetMetadataKey,
+        id: Annotated[UUID, Field(description="Asset ID")],
+        key: Annotated[StrictStr, Field(description="Metadata key")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -842,10 +854,10 @@ class AssetsApi:
 
         Delete a specific metadata key-value pair associated with the specified asset.
 
-        :param id: (required)
+        :param id: Asset ID (required)
         :type id: UUID
-        :param key: (required)
-        :type key: AssetMetadataKey
+        :param key: Metadata key (required)
+        :type key: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -892,8 +904,8 @@ class AssetsApi:
     @validate_call
     async def delete_asset_metadata_with_http_info(
         self,
-        id: UUID,
-        key: AssetMetadataKey,
+        id: Annotated[UUID, Field(description="Asset ID")],
+        key: Annotated[StrictStr, Field(description="Metadata key")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -910,10 +922,10 @@ class AssetsApi:
 
         Delete a specific metadata key-value pair associated with the specified asset.
 
-        :param id: (required)
+        :param id: Asset ID (required)
         :type id: UUID
-        :param key: (required)
-        :type key: AssetMetadataKey
+        :param key: Metadata key (required)
+        :type key: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -960,8 +972,8 @@ class AssetsApi:
     @validate_call
     async def delete_asset_metadata_without_preload_content(
         self,
-        id: UUID,
-        key: AssetMetadataKey,
+        id: Annotated[UUID, Field(description="Asset ID")],
+        key: Annotated[StrictStr, Field(description="Metadata key")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -978,10 +990,10 @@ class AssetsApi:
 
         Delete a specific metadata key-value pair associated with the specified asset.
 
-        :param id: (required)
+        :param id: Asset ID (required)
         :type id: UUID
-        :param key: (required)
-        :type key: AssetMetadataKey
+        :param key: Metadata key (required)
+        :type key: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1047,7 +1059,7 @@ class AssetsApi:
         if id is not None:
             _path_params["id"] = id
         if key is not None:
-            _path_params["key"] = key.value
+            _path_params["key"] = key
         # process the query parameters
         # process the header parameters
         # process the form parameters
@@ -1317,11 +1329,9 @@ class AssetsApi:
         )
 
     @validate_call
-    async def download_asset(
+    async def delete_bulk_asset_metadata(
         self,
-        id: UUID,
-        key: Optional[StrictStr] = None,
-        slug: Optional[StrictStr] = None,
+        asset_metadata_bulk_delete_dto: AssetMetadataBulkDeleteDto,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1333,17 +1343,13 @@ class AssetsApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> bytearray:
-        """Download original asset
+    ) -> None:
+        """Delete asset metadata
 
-        Downloads the original file of the specified asset.
+        Delete metadata key-value pairs for multiple assets.
 
-        :param id: (required)
-        :type id: UUID
-        :param key:
-        :type key: str
-        :param slug:
-        :type slug: str
+        :param asset_metadata_bulk_delete_dto: (required)
+        :type asset_metadata_bulk_delete_dto: AssetMetadataBulkDeleteDto
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1366,10 +1372,8 @@ class AssetsApi:
         :return: Returns the result object.
         """  # noqa: E501
 
-        _param = self._download_asset_serialize(
-            id=id,
-            key=key,
-            slug=slug,
+        _param = self._delete_bulk_asset_metadata_serialize(
+            asset_metadata_bulk_delete_dto=asset_metadata_bulk_delete_dto,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1377,7 +1381,7 @@ class AssetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "bytearray",
+            "204": None,
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout
@@ -1389,11 +1393,9 @@ class AssetsApi:
         ).data
 
     @validate_call
-    async def download_asset_with_http_info(
+    async def delete_bulk_asset_metadata_with_http_info(
         self,
-        id: UUID,
-        key: Optional[StrictStr] = None,
-        slug: Optional[StrictStr] = None,
+        asset_metadata_bulk_delete_dto: AssetMetadataBulkDeleteDto,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1405,17 +1407,13 @@ class AssetsApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ApiResponse[bytearray]:
-        """Download original asset
+    ) -> ApiResponse[None]:
+        """Delete asset metadata
 
-        Downloads the original file of the specified asset.
+        Delete metadata key-value pairs for multiple assets.
 
-        :param id: (required)
-        :type id: UUID
-        :param key:
-        :type key: str
-        :param slug:
-        :type slug: str
+        :param asset_metadata_bulk_delete_dto: (required)
+        :type asset_metadata_bulk_delete_dto: AssetMetadataBulkDeleteDto
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1438,10 +1436,8 @@ class AssetsApi:
         :return: Returns the result object.
         """  # noqa: E501
 
-        _param = self._download_asset_serialize(
-            id=id,
-            key=key,
-            slug=slug,
+        _param = self._delete_bulk_asset_metadata_serialize(
+            asset_metadata_bulk_delete_dto=asset_metadata_bulk_delete_dto,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1449,7 +1445,7 @@ class AssetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "bytearray",
+            "204": None,
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout
@@ -1461,11 +1457,9 @@ class AssetsApi:
         )
 
     @validate_call
-    async def download_asset_without_preload_content(
+    async def delete_bulk_asset_metadata_without_preload_content(
         self,
-        id: UUID,
-        key: Optional[StrictStr] = None,
-        slug: Optional[StrictStr] = None,
+        asset_metadata_bulk_delete_dto: AssetMetadataBulkDeleteDto,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1478,16 +1472,12 @@ class AssetsApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Download original asset
+        """Delete asset metadata
 
-        Downloads the original file of the specified asset.
+        Delete metadata key-value pairs for multiple assets.
 
-        :param id: (required)
-        :type id: UUID
-        :param key:
-        :type key: str
-        :param slug:
-        :type slug: str
+        :param asset_metadata_bulk_delete_dto: (required)
+        :type asset_metadata_bulk_delete_dto: AssetMetadataBulkDeleteDto
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1510,10 +1500,8 @@ class AssetsApi:
         :return: Returns the result object.
         """  # noqa: E501
 
-        _param = self._download_asset_serialize(
-            id=id,
-            key=key,
-            slug=slug,
+        _param = self._delete_bulk_asset_metadata_serialize(
+            asset_metadata_bulk_delete_dto=asset_metadata_bulk_delete_dto,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1521,18 +1509,16 @@ class AssetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "bytearray",
+            "204": None,
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout
         )
         return response_data.response
 
-    def _download_asset_serialize(
+    def _delete_bulk_asset_metadata_serialize(
         self,
-        id,
-        key,
-        slug,
+        asset_metadata_bulk_delete_dto,
         _request_auth,
         _content_type,
         _headers,
@@ -1552,31 +1538,29 @@ class AssetsApi:
         _body_params: Optional[bytes] = None
 
         # process the path parameters
-        if id is not None:
-            _path_params["id"] = id
         # process the query parameters
-        if key is not None:
-            _query_params.append(("key", key))
-
-        if slug is not None:
-            _query_params.append(("slug", slug))
-
         # process the header parameters
         # process the form parameters
         # process the body parameter
+        if asset_metadata_bulk_delete_dto is not None:
+            _body_params = asset_metadata_bulk_delete_dto
 
-        # set the HTTP header `Accept`
-        if "Accept" not in _header_params:
-            _header_params["Accept"] = self.api_client.select_header_accept(
-                ["application/octet-stream"]
+        # set the HTTP header `Content-Type`
+        if _content_type:
+            _header_params["Content-Type"] = _content_type
+        else:
+            _default_content_type = self.api_client.select_header_content_type(
+                ["application/json"]
             )
+            if _default_content_type is not None:
+                _header_params["Content-Type"] = _default_content_type
 
         # authentication setting
         _auth_settings: List[str] = ["cookie", "api_key", "bearer"]
 
         return self.api_client.param_serialize(
-            method="GET",
-            resource_path="/assets/{id}/original",
+            method="DELETE",
+            resource_path="/assets/metadata",
             path_params=_path_params,
             query_params=_query_params,
             header_params=_header_params,
@@ -1590,9 +1574,14 @@ class AssetsApi:
         )
 
     @validate_call
-    async def get_all_user_assets_by_device_id(
+    async def download_asset(
         self,
-        device_id: StrictStr,
+        id: UUID,
+        edited: Annotated[
+            Optional[StrictBool], Field(description="Return edited asset if available")
+        ] = None,
+        key: Optional[StrictStr] = None,
+        slug: Optional[StrictStr] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1604,13 +1593,19 @@ class AssetsApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> List[str]:
-        """(Deprecated) Retrieve assets by device ID
+    ) -> bytearray:
+        """Download original asset
 
-        Get all asset of a device that are in the database, ID only.
+        Downloads the original file of the specified asset.
 
-        :param device_id: (required)
-        :type device_id: str
+        :param id: (required)
+        :type id: UUID
+        :param edited: Return edited asset if available
+        :type edited: bool
+        :param key:
+        :type key: str
+        :param slug:
+        :type slug: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1632,12 +1627,12 @@ class AssetsApi:
         :type _host_index: int, optional
         :return: Returns the result object.
         """  # noqa: E501
-        warnings.warn(
-            "GET /assets/device/{deviceId} is deprecated.", DeprecationWarning
-        )
 
-        _param = self._get_all_user_assets_by_device_id_serialize(
-            device_id=device_id,
+        _param = self._download_asset_serialize(
+            id=id,
+            edited=edited,
+            key=key,
+            slug=slug,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1645,7 +1640,7 @@ class AssetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "List[str]",
+            "200": "bytearray",
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout
@@ -1657,9 +1652,14 @@ class AssetsApi:
         ).data
 
     @validate_call
-    async def get_all_user_assets_by_device_id_with_http_info(
+    async def download_asset_with_http_info(
         self,
-        device_id: StrictStr,
+        id: UUID,
+        edited: Annotated[
+            Optional[StrictBool], Field(description="Return edited asset if available")
+        ] = None,
+        key: Optional[StrictStr] = None,
+        slug: Optional[StrictStr] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1671,13 +1671,19 @@ class AssetsApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ApiResponse[List[str]]:
-        """(Deprecated) Retrieve assets by device ID
+    ) -> ApiResponse[bytearray]:
+        """Download original asset
 
-        Get all asset of a device that are in the database, ID only.
+        Downloads the original file of the specified asset.
 
-        :param device_id: (required)
-        :type device_id: str
+        :param id: (required)
+        :type id: UUID
+        :param edited: Return edited asset if available
+        :type edited: bool
+        :param key:
+        :type key: str
+        :param slug:
+        :type slug: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1699,12 +1705,12 @@ class AssetsApi:
         :type _host_index: int, optional
         :return: Returns the result object.
         """  # noqa: E501
-        warnings.warn(
-            "GET /assets/device/{deviceId} is deprecated.", DeprecationWarning
-        )
 
-        _param = self._get_all_user_assets_by_device_id_serialize(
-            device_id=device_id,
+        _param = self._download_asset_serialize(
+            id=id,
+            edited=edited,
+            key=key,
+            slug=slug,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1712,7 +1718,7 @@ class AssetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "List[str]",
+            "200": "bytearray",
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout
@@ -1724,9 +1730,14 @@ class AssetsApi:
         )
 
     @validate_call
-    async def get_all_user_assets_by_device_id_without_preload_content(
+    async def download_asset_without_preload_content(
         self,
-        device_id: StrictStr,
+        id: UUID,
+        edited: Annotated[
+            Optional[StrictBool], Field(description="Return edited asset if available")
+        ] = None,
+        key: Optional[StrictStr] = None,
+        slug: Optional[StrictStr] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1739,12 +1750,18 @@ class AssetsApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """(Deprecated) Retrieve assets by device ID
+        """Download original asset
 
-        Get all asset of a device that are in the database, ID only.
+        Downloads the original file of the specified asset.
 
-        :param device_id: (required)
-        :type device_id: str
+        :param id: (required)
+        :type id: UUID
+        :param edited: Return edited asset if available
+        :type edited: bool
+        :param key:
+        :type key: str
+        :param slug:
+        :type slug: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1766,12 +1783,12 @@ class AssetsApi:
         :type _host_index: int, optional
         :return: Returns the result object.
         """  # noqa: E501
-        warnings.warn(
-            "GET /assets/device/{deviceId} is deprecated.", DeprecationWarning
-        )
 
-        _param = self._get_all_user_assets_by_device_id_serialize(
-            device_id=device_id,
+        _param = self._download_asset_serialize(
+            id=id,
+            edited=edited,
+            key=key,
+            slug=slug,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1779,16 +1796,19 @@ class AssetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "List[str]",
+            "200": "bytearray",
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout
         )
         return response_data.response
 
-    def _get_all_user_assets_by_device_id_serialize(
+    def _download_asset_serialize(
         self,
-        device_id,
+        id,
+        edited,
+        key,
+        slug,
         _request_auth,
         _content_type,
         _headers,
@@ -1808,9 +1828,18 @@ class AssetsApi:
         _body_params: Optional[bytes] = None
 
         # process the path parameters
-        if device_id is not None:
-            _path_params["deviceId"] = device_id
+        if id is not None:
+            _path_params["id"] = id
         # process the query parameters
+        if edited is not None:
+            _query_params.append(("edited", edited))
+
+        if key is not None:
+            _query_params.append(("key", key))
+
+        if slug is not None:
+            _query_params.append(("slug", slug))
+
         # process the header parameters
         # process the form parameters
         # process the body parameter
@@ -1818,7 +1847,7 @@ class AssetsApi:
         # set the HTTP header `Accept`
         if "Accept" not in _header_params:
             _header_params["Accept"] = self.api_client.select_header_accept(
-                ["application/json"]
+                ["application/octet-stream"]
             )
 
         # authentication setting
@@ -1826,7 +1855,7 @@ class AssetsApi:
 
         return self.api_client.param_serialize(
             method="GET",
-            resource_path="/assets/device/{deviceId}",
+            resource_path="/assets/{id}/original",
             path_params=_path_params,
             query_params=_query_params,
             header_params=_header_params,
@@ -1840,11 +1869,10 @@ class AssetsApi:
         )
 
     @validate_call
-    async def get_asset_info(
+    async def edit_asset(
         self,
         id: UUID,
-        key: Optional[StrictStr] = None,
-        slug: Optional[StrictStr] = None,
+        asset_edit_action_list_dto: AssetEditActionListDto,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1856,17 +1884,15 @@ class AssetsApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> AssetResponseDto:
-        """Retrieve an asset
+    ) -> AssetEditsDto:
+        """Apply edits to an existing asset
 
-        Retrieve detailed information about a specific asset.
+        Apply a series of edit actions (crop, rotate, mirror) to the specified asset.
 
         :param id: (required)
         :type id: UUID
-        :param key:
-        :type key: str
-        :param slug:
-        :type slug: str
+        :param asset_edit_action_list_dto: (required)
+        :type asset_edit_action_list_dto: AssetEditActionListDto
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1889,10 +1915,9 @@ class AssetsApi:
         :return: Returns the result object.
         """  # noqa: E501
 
-        _param = self._get_asset_info_serialize(
+        _param = self._edit_asset_serialize(
             id=id,
-            key=key,
-            slug=slug,
+            asset_edit_action_list_dto=asset_edit_action_list_dto,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1900,7 +1925,7 @@ class AssetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "AssetResponseDto",
+            "200": "AssetEditsDto",
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout
@@ -1912,11 +1937,10 @@ class AssetsApi:
         ).data
 
     @validate_call
-    async def get_asset_info_with_http_info(
+    async def edit_asset_with_http_info(
         self,
         id: UUID,
-        key: Optional[StrictStr] = None,
-        slug: Optional[StrictStr] = None,
+        asset_edit_action_list_dto: AssetEditActionListDto,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -1928,17 +1952,15 @@ class AssetsApi:
         _content_type: Optional[StrictStr] = None,
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
-    ) -> ApiResponse[AssetResponseDto]:
-        """Retrieve an asset
+    ) -> ApiResponse[AssetEditsDto]:
+        """Apply edits to an existing asset
 
-        Retrieve detailed information about a specific asset.
+        Apply a series of edit actions (crop, rotate, mirror) to the specified asset.
 
         :param id: (required)
         :type id: UUID
-        :param key:
-        :type key: str
-        :param slug:
-        :type slug: str
+        :param asset_edit_action_list_dto: (required)
+        :type asset_edit_action_list_dto: AssetEditActionListDto
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -1961,10 +1983,9 @@ class AssetsApi:
         :return: Returns the result object.
         """  # noqa: E501
 
-        _param = self._get_asset_info_serialize(
+        _param = self._edit_asset_serialize(
             id=id,
-            key=key,
-            slug=slug,
+            asset_edit_action_list_dto=asset_edit_action_list_dto,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -1972,7 +1993,7 @@ class AssetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "AssetResponseDto",
+            "200": "AssetEditsDto",
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout
@@ -1984,11 +2005,10 @@ class AssetsApi:
         )
 
     @validate_call
-    async def get_asset_info_without_preload_content(
+    async def edit_asset_without_preload_content(
         self,
         id: UUID,
-        key: Optional[StrictStr] = None,
-        slug: Optional[StrictStr] = None,
+        asset_edit_action_list_dto: AssetEditActionListDto,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -2001,16 +2021,14 @@ class AssetsApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Retrieve an asset
+        """Apply edits to an existing asset
 
-        Retrieve detailed information about a specific asset.
+        Apply a series of edit actions (crop, rotate, mirror) to the specified asset.
 
         :param id: (required)
         :type id: UUID
-        :param key:
-        :type key: str
-        :param slug:
-        :type slug: str
+        :param asset_edit_action_list_dto: (required)
+        :type asset_edit_action_list_dto: AssetEditActionListDto
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -2033,10 +2051,9 @@ class AssetsApi:
         :return: Returns the result object.
         """  # noqa: E501
 
-        _param = self._get_asset_info_serialize(
+        _param = self._edit_asset_serialize(
             id=id,
-            key=key,
-            slug=slug,
+            asset_edit_action_list_dto=asset_edit_action_list_dto,
             _request_auth=_request_auth,
             _content_type=_content_type,
             _headers=_headers,
@@ -2044,18 +2061,17 @@ class AssetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
-            "200": "AssetResponseDto",
+            "200": "AssetEditsDto",
         }
         response_data = await self.api_client.call_api(
             *_param, _request_timeout=_request_timeout
         )
         return response_data.response
 
-    def _get_asset_info_serialize(
+    def _edit_asset_serialize(
         self,
         id,
-        key,
-        slug,
+        asset_edit_action_list_dto,
         _request_auth,
         _content_type,
         _headers,
@@ -2078,8 +2094,778 @@ class AssetsApi:
         if id is not None:
             _path_params["id"] = id
         # process the query parameters
-        if key is not None:
-            _query_params.append(("key", key))
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+        if asset_edit_action_list_dto is not None:
+            _body_params = asset_edit_action_list_dto
+
+        # set the HTTP header `Accept`
+        if "Accept" not in _header_params:
+            _header_params["Accept"] = self.api_client.select_header_accept(
+                ["application/json"]
+            )
+
+        # set the HTTP header `Content-Type`
+        if _content_type:
+            _header_params["Content-Type"] = _content_type
+        else:
+            _default_content_type = self.api_client.select_header_content_type(
+                ["application/json"]
+            )
+            if _default_content_type is not None:
+                _header_params["Content-Type"] = _default_content_type
+
+        # authentication setting
+        _auth_settings: List[str] = ["cookie", "api_key", "bearer"]
+
+        return self.api_client.param_serialize(
+            method="PUT",
+            resource_path="/assets/{id}/edits",
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth,
+        )
+
+    @validate_call
+    async def get_all_user_assets_by_device_id(
+        self,
+        device_id: Annotated[StrictStr, Field(description="Device ID")],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> List[str]:
+        """(Deprecated) Retrieve assets by device ID
+
+        Get all asset of a device that are in the database, ID only.
+
+        :param device_id: Device ID (required)
+        :type device_id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+        warnings.warn(
+            "GET /assets/device/{deviceId} is deprecated.", DeprecationWarning
+        )
+
+        _param = self._get_all_user_assets_by_device_id_serialize(
+            device_id=device_id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "200": "List[str]",
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        await response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+    @validate_call
+    async def get_all_user_assets_by_device_id_with_http_info(
+        self,
+        device_id: Annotated[StrictStr, Field(description="Device ID")],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[List[str]]:
+        """(Deprecated) Retrieve assets by device ID
+
+        Get all asset of a device that are in the database, ID only.
+
+        :param device_id: Device ID (required)
+        :type device_id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+        warnings.warn(
+            "GET /assets/device/{deviceId} is deprecated.", DeprecationWarning
+        )
+
+        _param = self._get_all_user_assets_by_device_id_serialize(
+            device_id=device_id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "200": "List[str]",
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        await response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+    @validate_call
+    async def get_all_user_assets_by_device_id_without_preload_content(
+        self,
+        device_id: Annotated[StrictStr, Field(description="Device ID")],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """(Deprecated) Retrieve assets by device ID
+
+        Get all asset of a device that are in the database, ID only.
+
+        :param device_id: Device ID (required)
+        :type device_id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+        warnings.warn(
+            "GET /assets/device/{deviceId} is deprecated.", DeprecationWarning
+        )
+
+        _param = self._get_all_user_assets_by_device_id_serialize(
+            device_id=device_id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "200": "List[str]",
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+    def _get_all_user_assets_by_device_id_serialize(
+        self,
+        device_id,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+        _host = None
+
+        _collection_formats: Dict[str, str] = {}
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if device_id is not None:
+            _path_params["deviceId"] = device_id
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+        # set the HTTP header `Accept`
+        if "Accept" not in _header_params:
+            _header_params["Accept"] = self.api_client.select_header_accept(
+                ["application/json"]
+            )
+
+        # authentication setting
+        _auth_settings: List[str] = ["cookie", "api_key", "bearer"]
+
+        return self.api_client.param_serialize(
+            method="GET",
+            resource_path="/assets/device/{deviceId}",
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth,
+        )
+
+    @validate_call
+    async def get_asset_edits(
+        self,
+        id: UUID,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> AssetEditsDto:
+        """Retrieve edits for an existing asset
+
+        Retrieve a series of edit actions (crop, rotate, mirror) associated with the specified asset.
+
+        :param id: (required)
+        :type id: UUID
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+
+        _param = self._get_asset_edits_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "200": "AssetEditsDto",
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        await response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+    @validate_call
+    async def get_asset_edits_with_http_info(
+        self,
+        id: UUID,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[AssetEditsDto]:
+        """Retrieve edits for an existing asset
+
+        Retrieve a series of edit actions (crop, rotate, mirror) associated with the specified asset.
+
+        :param id: (required)
+        :type id: UUID
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+
+        _param = self._get_asset_edits_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "200": "AssetEditsDto",
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        await response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+    @validate_call
+    async def get_asset_edits_without_preload_content(
+        self,
+        id: UUID,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Retrieve edits for an existing asset
+
+        Retrieve a series of edit actions (crop, rotate, mirror) associated with the specified asset.
+
+        :param id: (required)
+        :type id: UUID
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+
+        _param = self._get_asset_edits_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "200": "AssetEditsDto",
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+    def _get_asset_edits_serialize(
+        self,
+        id,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+        _host = None
+
+        _collection_formats: Dict[str, str] = {}
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if id is not None:
+            _path_params["id"] = id
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+        # set the HTTP header `Accept`
+        if "Accept" not in _header_params:
+            _header_params["Accept"] = self.api_client.select_header_accept(
+                ["application/json"]
+            )
+
+        # authentication setting
+        _auth_settings: List[str] = ["cookie", "api_key", "bearer"]
+
+        return self.api_client.param_serialize(
+            method="GET",
+            resource_path="/assets/{id}/edits",
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth,
+        )
+
+    @validate_call
+    async def get_asset_info(
+        self,
+        id: UUID,
+        key: Optional[StrictStr] = None,
+        slug: Optional[StrictStr] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> AssetResponseDto:
+        """Retrieve an asset
+
+        Retrieve detailed information about a specific asset.
+
+        :param id: (required)
+        :type id: UUID
+        :param key:
+        :type key: str
+        :param slug:
+        :type slug: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+
+        _param = self._get_asset_info_serialize(
+            id=id,
+            key=key,
+            slug=slug,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "200": "AssetResponseDto",
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        await response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+    @validate_call
+    async def get_asset_info_with_http_info(
+        self,
+        id: UUID,
+        key: Optional[StrictStr] = None,
+        slug: Optional[StrictStr] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[AssetResponseDto]:
+        """Retrieve an asset
+
+        Retrieve detailed information about a specific asset.
+
+        :param id: (required)
+        :type id: UUID
+        :param key:
+        :type key: str
+        :param slug:
+        :type slug: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+
+        _param = self._get_asset_info_serialize(
+            id=id,
+            key=key,
+            slug=slug,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "200": "AssetResponseDto",
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        await response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+    @validate_call
+    async def get_asset_info_without_preload_content(
+        self,
+        id: UUID,
+        key: Optional[StrictStr] = None,
+        slug: Optional[StrictStr] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Retrieve an asset
+
+        Retrieve detailed information about a specific asset.
+
+        :param id: (required)
+        :type id: UUID
+        :param key:
+        :type key: str
+        :param slug:
+        :type slug: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+
+        _param = self._get_asset_info_serialize(
+            id=id,
+            key=key,
+            slug=slug,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "200": "AssetResponseDto",
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+    def _get_asset_info_serialize(
+        self,
+        id,
+        key,
+        slug,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+        _host = None
+
+        _collection_formats: Dict[str, str] = {}
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if id is not None:
+            _path_params["id"] = id
+        # process the query parameters
+        if key is not None:
+            _query_params.append(("key", key))
 
         if slug is not None:
             _query_params.append(("slug", slug))
@@ -2356,8 +3142,8 @@ class AssetsApi:
     @validate_call
     async def get_asset_metadata_by_key(
         self,
-        id: UUID,
-        key: AssetMetadataKey,
+        id: Annotated[UUID, Field(description="Asset ID")],
+        key: Annotated[StrictStr, Field(description="Metadata key")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -2374,10 +3160,10 @@ class AssetsApi:
 
         Retrieve the value of a specific metadata key associated with the specified asset.
 
-        :param id: (required)
+        :param id: Asset ID (required)
         :type id: UUID
-        :param key: (required)
-        :type key: AssetMetadataKey
+        :param key: Metadata key (required)
+        :type key: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -2424,8 +3210,8 @@ class AssetsApi:
     @validate_call
     async def get_asset_metadata_by_key_with_http_info(
         self,
-        id: UUID,
-        key: AssetMetadataKey,
+        id: Annotated[UUID, Field(description="Asset ID")],
+        key: Annotated[StrictStr, Field(description="Metadata key")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -2442,10 +3228,10 @@ class AssetsApi:
 
         Retrieve the value of a specific metadata key associated with the specified asset.
 
-        :param id: (required)
+        :param id: Asset ID (required)
         :type id: UUID
-        :param key: (required)
-        :type key: AssetMetadataKey
+        :param key: Metadata key (required)
+        :type key: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -2492,8 +3278,8 @@ class AssetsApi:
     @validate_call
     async def get_asset_metadata_by_key_without_preload_content(
         self,
-        id: UUID,
-        key: AssetMetadataKey,
+        id: Annotated[UUID, Field(description="Asset ID")],
+        key: Annotated[StrictStr, Field(description="Metadata key")],
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -2510,10 +3296,10 @@ class AssetsApi:
 
         Retrieve the value of a specific metadata key associated with the specified asset.
 
-        :param id: (required)
+        :param id: Asset ID (required)
         :type id: UUID
-        :param key: (required)
-        :type key: AssetMetadataKey
+        :param key: Metadata key (required)
+        :type key: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
                                  timeout. It can also be a pair (tuple) of
@@ -2579,7 +3365,7 @@ class AssetsApi:
         if id is not None:
             _path_params["id"] = id
         if key is not None:
-            _path_params["key"] = key.value
+            _path_params["key"] = key
         # process the query parameters
         # process the header parameters
         # process the form parameters
@@ -2853,9 +3639,15 @@ class AssetsApi:
     @validate_call
     async def get_asset_statistics(
         self,
-        is_favorite: Optional[StrictBool] = None,
-        is_trashed: Optional[StrictBool] = None,
-        visibility: Optional[AssetVisibility] = None,
+        is_favorite: Annotated[
+            Optional[StrictBool], Field(description="Filter by favorite status")
+        ] = None,
+        is_trashed: Annotated[
+            Optional[StrictBool], Field(description="Filter by trash status")
+        ] = None,
+        visibility: Annotated[
+            Optional[AssetVisibility], Field(description="Filter by visibility")
+        ] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -2872,11 +3664,11 @@ class AssetsApi:
 
         Retrieve various statistics about the assets owned by the authenticated user.
 
-        :param is_favorite:
+        :param is_favorite: Filter by favorite status
         :type is_favorite: bool
-        :param is_trashed:
+        :param is_trashed: Filter by trash status
         :type is_trashed: bool
-        :param visibility:
+        :param visibility: Filter by visibility
         :type visibility: AssetVisibility
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -2925,9 +3717,15 @@ class AssetsApi:
     @validate_call
     async def get_asset_statistics_with_http_info(
         self,
-        is_favorite: Optional[StrictBool] = None,
-        is_trashed: Optional[StrictBool] = None,
-        visibility: Optional[AssetVisibility] = None,
+        is_favorite: Annotated[
+            Optional[StrictBool], Field(description="Filter by favorite status")
+        ] = None,
+        is_trashed: Annotated[
+            Optional[StrictBool], Field(description="Filter by trash status")
+        ] = None,
+        visibility: Annotated[
+            Optional[AssetVisibility], Field(description="Filter by visibility")
+        ] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -2944,11 +3742,11 @@ class AssetsApi:
 
         Retrieve various statistics about the assets owned by the authenticated user.
 
-        :param is_favorite:
+        :param is_favorite: Filter by favorite status
         :type is_favorite: bool
-        :param is_trashed:
+        :param is_trashed: Filter by trash status
         :type is_trashed: bool
-        :param visibility:
+        :param visibility: Filter by visibility
         :type visibility: AssetVisibility
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -2997,9 +3795,15 @@ class AssetsApi:
     @validate_call
     async def get_asset_statistics_without_preload_content(
         self,
-        is_favorite: Optional[StrictBool] = None,
-        is_trashed: Optional[StrictBool] = None,
-        visibility: Optional[AssetVisibility] = None,
+        is_favorite: Annotated[
+            Optional[StrictBool], Field(description="Filter by favorite status")
+        ] = None,
+        is_trashed: Annotated[
+            Optional[StrictBool], Field(description="Filter by trash status")
+        ] = None,
+        visibility: Annotated[
+            Optional[AssetVisibility], Field(description="Filter by visibility")
+        ] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -3016,11 +3820,11 @@ class AssetsApi:
 
         Retrieve various statistics about the assets owned by the authenticated user.
 
-        :param is_favorite:
+        :param is_favorite: Filter by favorite status
         :type is_favorite: bool
-        :param is_trashed:
+        :param is_trashed: Filter by trash status
         :type is_trashed: bool
-        :param visibility:
+        :param visibility: Filter by visibility
         :type visibility: AssetVisibility
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -3127,11 +3931,14 @@ class AssetsApi:
     @validate_call
     async def get_random(
         self,
-        count: Optional[
-            Union[
-                Annotated[float, Field(strict=True, ge=1)],
-                Annotated[int, Field(strict=True, ge=1)],
-            ]
+        count: Annotated[
+            Optional[
+                Union[
+                    Annotated[float, Field(strict=True, ge=1)],
+                    Annotated[int, Field(strict=True, ge=1)],
+                ]
+            ],
+            Field(description="Number of random assets to return"),
         ] = None,
         _request_timeout: Union[
             None,
@@ -3149,7 +3956,7 @@ class AssetsApi:
 
         Retrieve a specified number of random assets for the authenticated user.
 
-        :param count:
+        :param count: Number of random assets to return
         :type count: float
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -3197,11 +4004,14 @@ class AssetsApi:
     @validate_call
     async def get_random_with_http_info(
         self,
-        count: Optional[
-            Union[
-                Annotated[float, Field(strict=True, ge=1)],
-                Annotated[int, Field(strict=True, ge=1)],
-            ]
+        count: Annotated[
+            Optional[
+                Union[
+                    Annotated[float, Field(strict=True, ge=1)],
+                    Annotated[int, Field(strict=True, ge=1)],
+                ]
+            ],
+            Field(description="Number of random assets to return"),
         ] = None,
         _request_timeout: Union[
             None,
@@ -3219,7 +4029,7 @@ class AssetsApi:
 
         Retrieve a specified number of random assets for the authenticated user.
 
-        :param count:
+        :param count: Number of random assets to return
         :type count: float
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -3267,11 +4077,14 @@ class AssetsApi:
     @validate_call
     async def get_random_without_preload_content(
         self,
-        count: Optional[
-            Union[
-                Annotated[float, Field(strict=True, ge=1)],
-                Annotated[int, Field(strict=True, ge=1)],
-            ]
+        count: Annotated[
+            Optional[
+                Union[
+                    Annotated[float, Field(strict=True, ge=1)],
+                    Annotated[int, Field(strict=True, ge=1)],
+                ]
+            ],
+            Field(description="Number of random assets to return"),
         ] = None,
         _request_timeout: Union[
             None,
@@ -3289,7 +4102,7 @@ class AssetsApi:
 
         Retrieve a specified number of random assets for the authenticated user.
 
-        :param count:
+        :param count: Number of random assets to return
         :type count: float
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -3643,8 +4456,243 @@ class AssetsApi:
         _auth_settings: List[str] = ["cookie", "api_key", "bearer"]
 
         return self.api_client.param_serialize(
-            method="GET",
-            resource_path="/assets/{id}/video/playback",
+            method="GET",
+            resource_path="/assets/{id}/video/playback",
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth,
+        )
+
+    @validate_call
+    async def remove_asset_edits(
+        self,
+        id: UUID,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> None:
+        """Remove edits from an existing asset
+
+        Removes all edit actions (crop, rotate, mirror) associated with the specified asset.
+
+        :param id: (required)
+        :type id: UUID
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+
+        _param = self._remove_asset_edits_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "204": None,
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        await response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+    @validate_call
+    async def remove_asset_edits_with_http_info(
+        self,
+        id: UUID,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[None]:
+        """Remove edits from an existing asset
+
+        Removes all edit actions (crop, rotate, mirror) associated with the specified asset.
+
+        :param id: (required)
+        :type id: UUID
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+
+        _param = self._remove_asset_edits_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "204": None,
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        await response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+    @validate_call
+    async def remove_asset_edits_without_preload_content(
+        self,
+        id: UUID,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Remove edits from an existing asset
+
+        Removes all edit actions (crop, rotate, mirror) associated with the specified asset.
+
+        :param id: (required)
+        :type id: UUID
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+
+        _param = self._remove_asset_edits_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "204": None,
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+    def _remove_asset_edits_serialize(
+        self,
+        id,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+        _host = None
+
+        _collection_formats: Dict[str, str] = {}
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if id is not None:
+            _path_params["id"] = id
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+        # authentication setting
+        _auth_settings: List[str] = ["cookie", "api_key", "bearer"]
+
+        return self.api_client.param_serialize(
+            method="DELETE",
+            resource_path="/assets/{id}/edits",
             path_params=_path_params,
             query_params=_query_params,
             header_params=_header_params,
@@ -3661,15 +4709,22 @@ class AssetsApi:
     async def replace_asset(
         self,
         id: UUID,
-        asset_data: Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]],
-        device_asset_id: StrictStr,
-        device_id: StrictStr,
-        file_created_at: datetime,
-        file_modified_at: datetime,
+        asset_data: Annotated[
+            Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]],
+            Field(description="Asset file data"),
+        ],
+        device_asset_id: Annotated[StrictStr, Field(description="Device asset ID")],
+        device_id: Annotated[StrictStr, Field(description="Device ID")],
+        file_created_at: Annotated[datetime, Field(description="File creation date")],
+        file_modified_at: Annotated[
+            datetime, Field(description="File modification date")
+        ],
         key: Optional[StrictStr] = None,
         slug: Optional[StrictStr] = None,
-        duration: Optional[StrictStr] = None,
-        filename: Optional[StrictStr] = None,
+        duration: Annotated[
+            Optional[StrictStr], Field(description="Duration (for videos)")
+        ] = None,
+        filename: Annotated[Optional[StrictStr], Field(description="Filename")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -3688,23 +4743,23 @@ class AssetsApi:
 
         :param id: (required)
         :type id: UUID
-        :param asset_data: (required)
+        :param asset_data: Asset file data (required)
         :type asset_data: bytearray
-        :param device_asset_id: (required)
+        :param device_asset_id: Device asset ID (required)
         :type device_asset_id: str
-        :param device_id: (required)
+        :param device_id: Device ID (required)
         :type device_id: str
-        :param file_created_at: (required)
+        :param file_created_at: File creation date (required)
         :type file_created_at: datetime
-        :param file_modified_at: (required)
+        :param file_modified_at: File modification date (required)
         :type file_modified_at: datetime
         :param key:
         :type key: str
         :param slug:
         :type slug: str
-        :param duration:
+        :param duration: Duration (for videos)
         :type duration: str
-        :param filename:
+        :param filename: Filename
         :type filename: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -3762,15 +4817,22 @@ class AssetsApi:
     async def replace_asset_with_http_info(
         self,
         id: UUID,
-        asset_data: Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]],
-        device_asset_id: StrictStr,
-        device_id: StrictStr,
-        file_created_at: datetime,
-        file_modified_at: datetime,
+        asset_data: Annotated[
+            Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]],
+            Field(description="Asset file data"),
+        ],
+        device_asset_id: Annotated[StrictStr, Field(description="Device asset ID")],
+        device_id: Annotated[StrictStr, Field(description="Device ID")],
+        file_created_at: Annotated[datetime, Field(description="File creation date")],
+        file_modified_at: Annotated[
+            datetime, Field(description="File modification date")
+        ],
         key: Optional[StrictStr] = None,
         slug: Optional[StrictStr] = None,
-        duration: Optional[StrictStr] = None,
-        filename: Optional[StrictStr] = None,
+        duration: Annotated[
+            Optional[StrictStr], Field(description="Duration (for videos)")
+        ] = None,
+        filename: Annotated[Optional[StrictStr], Field(description="Filename")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -3789,23 +4851,23 @@ class AssetsApi:
 
         :param id: (required)
         :type id: UUID
-        :param asset_data: (required)
+        :param asset_data: Asset file data (required)
         :type asset_data: bytearray
-        :param device_asset_id: (required)
+        :param device_asset_id: Device asset ID (required)
         :type device_asset_id: str
-        :param device_id: (required)
+        :param device_id: Device ID (required)
         :type device_id: str
-        :param file_created_at: (required)
+        :param file_created_at: File creation date (required)
         :type file_created_at: datetime
-        :param file_modified_at: (required)
+        :param file_modified_at: File modification date (required)
         :type file_modified_at: datetime
         :param key:
         :type key: str
         :param slug:
         :type slug: str
-        :param duration:
+        :param duration: Duration (for videos)
         :type duration: str
-        :param filename:
+        :param filename: Filename
         :type filename: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -3863,15 +4925,22 @@ class AssetsApi:
     async def replace_asset_without_preload_content(
         self,
         id: UUID,
-        asset_data: Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]],
-        device_asset_id: StrictStr,
-        device_id: StrictStr,
-        file_created_at: datetime,
-        file_modified_at: datetime,
+        asset_data: Annotated[
+            Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]],
+            Field(description="Asset file data"),
+        ],
+        device_asset_id: Annotated[StrictStr, Field(description="Device asset ID")],
+        device_id: Annotated[StrictStr, Field(description="Device ID")],
+        file_created_at: Annotated[datetime, Field(description="File creation date")],
+        file_modified_at: Annotated[
+            datetime, Field(description="File modification date")
+        ],
         key: Optional[StrictStr] = None,
         slug: Optional[StrictStr] = None,
-        duration: Optional[StrictStr] = None,
-        filename: Optional[StrictStr] = None,
+        duration: Annotated[
+            Optional[StrictStr], Field(description="Duration (for videos)")
+        ] = None,
+        filename: Annotated[Optional[StrictStr], Field(description="Filename")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -3890,23 +4959,23 @@ class AssetsApi:
 
         :param id: (required)
         :type id: UUID
-        :param asset_data: (required)
+        :param asset_data: Asset file data (required)
         :type asset_data: bytearray
-        :param device_asset_id: (required)
+        :param device_asset_id: Device asset ID (required)
         :type device_asset_id: str
-        :param device_id: (required)
+        :param device_id: Device ID (required)
         :type device_id: str
-        :param file_created_at: (required)
+        :param file_created_at: File creation date (required)
         :type file_created_at: datetime
-        :param file_modified_at: (required)
+        :param file_modified_at: File modification date (required)
         :type file_modified_at: datetime
         :param key:
         :type key: str
         :param slug:
         :type slug: str
-        :param duration:
+        :param duration: Duration (for videos)
         :type duration: str
-        :param filename:
+        :param filename: Filename
         :type filename: str
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -5070,15 +6139,270 @@ class AssetsApi:
             _request_auth=_request_auth,
         )
 
+    @validate_call
+    async def update_bulk_asset_metadata(
+        self,
+        asset_metadata_bulk_upsert_dto: AssetMetadataBulkUpsertDto,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> List[AssetMetadataBulkResponseDto]:
+        """Upsert asset metadata
+
+        Upsert metadata key-value pairs for multiple assets.
+
+        :param asset_metadata_bulk_upsert_dto: (required)
+        :type asset_metadata_bulk_upsert_dto: AssetMetadataBulkUpsertDto
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+
+        _param = self._update_bulk_asset_metadata_serialize(
+            asset_metadata_bulk_upsert_dto=asset_metadata_bulk_upsert_dto,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "200": "List[AssetMetadataBulkResponseDto]",
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        await response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+    @validate_call
+    async def update_bulk_asset_metadata_with_http_info(
+        self,
+        asset_metadata_bulk_upsert_dto: AssetMetadataBulkUpsertDto,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[List[AssetMetadataBulkResponseDto]]:
+        """Upsert asset metadata
+
+        Upsert metadata key-value pairs for multiple assets.
+
+        :param asset_metadata_bulk_upsert_dto: (required)
+        :type asset_metadata_bulk_upsert_dto: AssetMetadataBulkUpsertDto
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+
+        _param = self._update_bulk_asset_metadata_serialize(
+            asset_metadata_bulk_upsert_dto=asset_metadata_bulk_upsert_dto,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "200": "List[AssetMetadataBulkResponseDto]",
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        await response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+    @validate_call
+    async def update_bulk_asset_metadata_without_preload_content(
+        self,
+        asset_metadata_bulk_upsert_dto: AssetMetadataBulkUpsertDto,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)], Annotated[StrictFloat, Field(gt=0)]
+            ],
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Upsert asset metadata
+
+        Upsert metadata key-value pairs for multiple assets.
+
+        :param asset_metadata_bulk_upsert_dto: (required)
+        :type asset_metadata_bulk_upsert_dto: AssetMetadataBulkUpsertDto
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """  # noqa: E501
+
+        _param = self._update_bulk_asset_metadata_serialize(
+            asset_metadata_bulk_upsert_dto=asset_metadata_bulk_upsert_dto,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index,
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            "200": "List[AssetMetadataBulkResponseDto]",
+        }
+        response_data = await self.api_client.call_api(
+            *_param, _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+    def _update_bulk_asset_metadata_serialize(
+        self,
+        asset_metadata_bulk_upsert_dto,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+        _host = None
+
+        _collection_formats: Dict[str, str] = {}
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+        if asset_metadata_bulk_upsert_dto is not None:
+            _body_params = asset_metadata_bulk_upsert_dto
+
+        # set the HTTP header `Accept`
+        if "Accept" not in _header_params:
+            _header_params["Accept"] = self.api_client.select_header_accept(
+                ["application/json"]
+            )
+
+        # set the HTTP header `Content-Type`
+        if _content_type:
+            _header_params["Content-Type"] = _content_type
+        else:
+            _default_content_type = self.api_client.select_header_content_type(
+                ["application/json"]
+            )
+            if _default_content_type is not None:
+                _header_params["Content-Type"] = _default_content_type
+
+        # authentication setting
+        _auth_settings: List[str] = ["cookie", "api_key", "bearer"]
+
+        return self.api_client.param_serialize(
+            method="PUT",
+            resource_path="/assets/metadata",
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth,
+        )
+
     @validate_call
     async def upload_asset(
         self,
-        asset_data: Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]],
-        device_asset_id: StrictStr,
-        device_id: StrictStr,
-        file_created_at: datetime,
-        file_modified_at: datetime,
-        metadata: Optional[List[AssetMetadataUpsertItemDto]] = None,
+        asset_data: Annotated[
+            Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]],
+            Field(description="Asset file data"),
+        ],
+        device_asset_id: Annotated[StrictStr, Field(description="Device asset ID")],
+        device_id: Annotated[StrictStr, Field(description="Device ID")],
+        file_created_at: Annotated[datetime, Field(description="File creation date")],
+        file_modified_at: Annotated[
+            datetime, Field(description="File modification date")
+        ],
         key: Optional[StrictStr] = None,
         slug: Optional[StrictStr] = None,
         x_immich_checksum: Annotated[
@@ -5087,14 +6411,27 @@ class AssetsApi:
                 description="sha1 checksum that can be used for duplicate detection before the file is uploaded"
             ),
         ] = None,
-        duration: Optional[StrictStr] = None,
-        filename: Optional[StrictStr] = None,
-        is_favorite: Optional[StrictBool] = None,
-        live_photo_video_id: Optional[UUID] = None,
-        sidecar_data: Optional[
-            Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]
+        duration: Annotated[
+            Optional[StrictStr], Field(description="Duration (for videos)")
+        ] = None,
+        filename: Annotated[Optional[StrictStr], Field(description="Filename")] = None,
+        is_favorite: Annotated[
+            Optional[StrictBool], Field(description="Mark as favorite")
+        ] = None,
+        live_photo_video_id: Annotated[
+            Optional[UUID], Field(description="Live photo video ID")
+        ] = None,
+        metadata: Annotated[
+            Optional[List[AssetMetadataUpsertItemDto]],
+            Field(description="Asset metadata items"),
+        ] = None,
+        sidecar_data: Annotated[
+            Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]],
+            Field(description="Sidecar file data"),
+        ] = None,
+        visibility: Annotated[
+            Optional[Any], Field(description="Asset visibility")
         ] = None,
-        visibility: Optional[Any] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -5111,35 +6448,35 @@ class AssetsApi:
 
         Uploads a new asset to the server.
 
-        :param asset_data: (required)
+        :param asset_data: Asset file data (required)
         :type asset_data: bytearray
-        :param device_asset_id: (required)
+        :param device_asset_id: Device asset ID (required)
         :type device_asset_id: str
-        :param device_id: (required)
+        :param device_id: Device ID (required)
         :type device_id: str
-        :param file_created_at: (required)
+        :param file_created_at: File creation date (required)
         :type file_created_at: datetime
-        :param file_modified_at: (required)
+        :param file_modified_at: File modification date (required)
         :type file_modified_at: datetime
-        :param metadata:
-        :type metadata: Optional[List[AssetMetadataUpsertItemDto]]
         :param key:
         :type key: str
         :param slug:
         :type slug: str
         :param x_immich_checksum: sha1 checksum that can be used for duplicate detection before the file is uploaded
         :type x_immich_checksum: str
-        :param duration:
+        :param duration: Duration (for videos)
         :type duration: str
-        :param filename:
+        :param filename: Filename
         :type filename: str
-        :param is_favorite:
+        :param is_favorite: Mark as favorite
         :type is_favorite: bool
-        :param live_photo_video_id:
+        :param live_photo_video_id: Live photo video ID
         :type live_photo_video_id: UUID
-        :param sidecar_data:
+        :param metadata: Asset metadata items
+        :type metadata: List[AssetMetadataUpsertItemDto]
+        :param sidecar_data: Sidecar file data
         :type sidecar_data: bytearray
-        :param visibility:
+        :param visibility: Asset visibility
         :type visibility: AssetVisibility
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -5169,7 +6506,6 @@ class AssetsApi:
             device_id=device_id,
             file_created_at=file_created_at,
             file_modified_at=file_modified_at,
-            metadata=metadata,
             key=key,
             slug=slug,
             x_immich_checksum=x_immich_checksum,
@@ -5177,6 +6513,7 @@ class AssetsApi:
             filename=filename,
             is_favorite=is_favorite,
             live_photo_video_id=live_photo_video_id,
+            metadata=metadata,
             sidecar_data=sidecar_data,
             visibility=visibility,
             _request_auth=_request_auth,
@@ -5186,6 +6523,7 @@ class AssetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
+            "200": "AssetMediaResponseDto",
             "201": "AssetMediaResponseDto",
         }
         response_data = await self.api_client.call_api(
@@ -5200,12 +6538,16 @@ class AssetsApi:
     @validate_call
     async def upload_asset_with_http_info(
         self,
-        asset_data: Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]],
-        device_asset_id: StrictStr,
-        device_id: StrictStr,
-        file_created_at: datetime,
-        file_modified_at: datetime,
-        metadata: Optional[List[AssetMetadataUpsertItemDto]] = None,
+        asset_data: Annotated[
+            Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]],
+            Field(description="Asset file data"),
+        ],
+        device_asset_id: Annotated[StrictStr, Field(description="Device asset ID")],
+        device_id: Annotated[StrictStr, Field(description="Device ID")],
+        file_created_at: Annotated[datetime, Field(description="File creation date")],
+        file_modified_at: Annotated[
+            datetime, Field(description="File modification date")
+        ],
         key: Optional[StrictStr] = None,
         slug: Optional[StrictStr] = None,
         x_immich_checksum: Annotated[
@@ -5214,14 +6556,27 @@ class AssetsApi:
                 description="sha1 checksum that can be used for duplicate detection before the file is uploaded"
             ),
         ] = None,
-        duration: Optional[StrictStr] = None,
-        filename: Optional[StrictStr] = None,
-        is_favorite: Optional[StrictBool] = None,
-        live_photo_video_id: Optional[UUID] = None,
-        sidecar_data: Optional[
-            Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]
+        duration: Annotated[
+            Optional[StrictStr], Field(description="Duration (for videos)")
+        ] = None,
+        filename: Annotated[Optional[StrictStr], Field(description="Filename")] = None,
+        is_favorite: Annotated[
+            Optional[StrictBool], Field(description="Mark as favorite")
+        ] = None,
+        live_photo_video_id: Annotated[
+            Optional[UUID], Field(description="Live photo video ID")
+        ] = None,
+        metadata: Annotated[
+            Optional[List[AssetMetadataUpsertItemDto]],
+            Field(description="Asset metadata items"),
+        ] = None,
+        sidecar_data: Annotated[
+            Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]],
+            Field(description="Sidecar file data"),
+        ] = None,
+        visibility: Annotated[
+            Optional[Any], Field(description="Asset visibility")
         ] = None,
-        visibility: Optional[Any] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -5238,35 +6593,35 @@ class AssetsApi:
 
         Uploads a new asset to the server.
 
-        :param asset_data: (required)
+        :param asset_data: Asset file data (required)
         :type asset_data: bytearray
-        :param device_asset_id: (required)
+        :param device_asset_id: Device asset ID (required)
         :type device_asset_id: str
-        :param device_id: (required)
+        :param device_id: Device ID (required)
         :type device_id: str
-        :param file_created_at: (required)
+        :param file_created_at: File creation date (required)
         :type file_created_at: datetime
-        :param file_modified_at: (required)
+        :param file_modified_at: File modification date (required)
         :type file_modified_at: datetime
-        :param metadata:
-        :type metadata: Optional[List[AssetMetadataUpsertItemDto]]
         :param key:
         :type key: str
         :param slug:
         :type slug: str
         :param x_immich_checksum: sha1 checksum that can be used for duplicate detection before the file is uploaded
         :type x_immich_checksum: str
-        :param duration:
+        :param duration: Duration (for videos)
         :type duration: str
-        :param filename:
+        :param filename: Filename
         :type filename: str
-        :param is_favorite:
+        :param is_favorite: Mark as favorite
         :type is_favorite: bool
-        :param live_photo_video_id:
+        :param live_photo_video_id: Live photo video ID
         :type live_photo_video_id: UUID
-        :param sidecar_data:
+        :param metadata: Asset metadata items
+        :type metadata: List[AssetMetadataUpsertItemDto]
+        :param sidecar_data: Sidecar file data
         :type sidecar_data: bytearray
-        :param visibility:
+        :param visibility: Asset visibility
         :type visibility: AssetVisibility
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -5296,7 +6651,6 @@ class AssetsApi:
             device_id=device_id,
             file_created_at=file_created_at,
             file_modified_at=file_modified_at,
-            metadata=metadata,
             key=key,
             slug=slug,
             x_immich_checksum=x_immich_checksum,
@@ -5304,6 +6658,7 @@ class AssetsApi:
             filename=filename,
             is_favorite=is_favorite,
             live_photo_video_id=live_photo_video_id,
+            metadata=metadata,
             sidecar_data=sidecar_data,
             visibility=visibility,
             _request_auth=_request_auth,
@@ -5313,6 +6668,7 @@ class AssetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
+            "200": "AssetMediaResponseDto",
             "201": "AssetMediaResponseDto",
         }
         response_data = await self.api_client.call_api(
@@ -5327,12 +6683,16 @@ class AssetsApi:
     @validate_call
     async def upload_asset_without_preload_content(
         self,
-        asset_data: Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]],
-        device_asset_id: StrictStr,
-        device_id: StrictStr,
-        file_created_at: datetime,
-        file_modified_at: datetime,
-        metadata: Optional[List[AssetMetadataUpsertItemDto]] = None,
+        asset_data: Annotated[
+            Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]],
+            Field(description="Asset file data"),
+        ],
+        device_asset_id: Annotated[StrictStr, Field(description="Device asset ID")],
+        device_id: Annotated[StrictStr, Field(description="Device ID")],
+        file_created_at: Annotated[datetime, Field(description="File creation date")],
+        file_modified_at: Annotated[
+            datetime, Field(description="File modification date")
+        ],
         key: Optional[StrictStr] = None,
         slug: Optional[StrictStr] = None,
         x_immich_checksum: Annotated[
@@ -5341,14 +6701,27 @@ class AssetsApi:
                 description="sha1 checksum that can be used for duplicate detection before the file is uploaded"
             ),
         ] = None,
-        duration: Optional[StrictStr] = None,
-        filename: Optional[StrictStr] = None,
-        is_favorite: Optional[StrictBool] = None,
-        live_photo_video_id: Optional[UUID] = None,
-        sidecar_data: Optional[
-            Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]
+        duration: Annotated[
+            Optional[StrictStr], Field(description="Duration (for videos)")
+        ] = None,
+        filename: Annotated[Optional[StrictStr], Field(description="Filename")] = None,
+        is_favorite: Annotated[
+            Optional[StrictBool], Field(description="Mark as favorite")
+        ] = None,
+        live_photo_video_id: Annotated[
+            Optional[UUID], Field(description="Live photo video ID")
+        ] = None,
+        metadata: Annotated[
+            Optional[List[AssetMetadataUpsertItemDto]],
+            Field(description="Asset metadata items"),
+        ] = None,
+        sidecar_data: Annotated[
+            Optional[Union[StrictBytes, StrictStr, Tuple[StrictStr, StrictBytes]]],
+            Field(description="Sidecar file data"),
+        ] = None,
+        visibility: Annotated[
+            Optional[Any], Field(description="Asset visibility")
         ] = None,
-        visibility: Optional[Any] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -5365,35 +6738,35 @@ class AssetsApi:
 
         Uploads a new asset to the server.
 
-        :param asset_data: (required)
+        :param asset_data: Asset file data (required)
         :type asset_data: bytearray
-        :param device_asset_id: (required)
+        :param device_asset_id: Device asset ID (required)
         :type device_asset_id: str
-        :param device_id: (required)
+        :param device_id: Device ID (required)
         :type device_id: str
-        :param file_created_at: (required)
+        :param file_created_at: File creation date (required)
         :type file_created_at: datetime
-        :param file_modified_at: (required)
+        :param file_modified_at: File modification date (required)
         :type file_modified_at: datetime
-        :param metadata:
-        :type metadata: Optional[List[AssetMetadataUpsertItemDto]]
         :param key:
         :type key: str
         :param slug:
         :type slug: str
         :param x_immich_checksum: sha1 checksum that can be used for duplicate detection before the file is uploaded
         :type x_immich_checksum: str
-        :param duration:
+        :param duration: Duration (for videos)
         :type duration: str
-        :param filename:
+        :param filename: Filename
         :type filename: str
-        :param is_favorite:
+        :param is_favorite: Mark as favorite
         :type is_favorite: bool
-        :param live_photo_video_id:
+        :param live_photo_video_id: Live photo video ID
         :type live_photo_video_id: UUID
-        :param sidecar_data:
+        :param metadata: Asset metadata items
+        :type metadata: List[AssetMetadataUpsertItemDto]
+        :param sidecar_data: Sidecar file data
         :type sidecar_data: bytearray
-        :param visibility:
+        :param visibility: Asset visibility
         :type visibility: AssetVisibility
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -5423,7 +6796,6 @@ class AssetsApi:
             device_id=device_id,
             file_created_at=file_created_at,
             file_modified_at=file_modified_at,
-            metadata=metadata,
             key=key,
             slug=slug,
             x_immich_checksum=x_immich_checksum,
@@ -5431,6 +6803,7 @@ class AssetsApi:
             filename=filename,
             is_favorite=is_favorite,
             live_photo_video_id=live_photo_video_id,
+            metadata=metadata,
             sidecar_data=sidecar_data,
             visibility=visibility,
             _request_auth=_request_auth,
@@ -5440,6 +6813,7 @@ class AssetsApi:
         )
 
         _response_types_map: Dict[str, Optional[str]] = {
+            "200": "AssetMediaResponseDto",
             "201": "AssetMediaResponseDto",
         }
         response_data = await self.api_client.call_api(
@@ -5454,7 +6828,6 @@ class AssetsApi:
         device_id,
         file_created_at,
         file_modified_at,
-        metadata,
         key,
         slug,
         x_immich_checksum,
@@ -5462,6 +6835,7 @@ class AssetsApi:
         filename,
         is_favorite,
         live_photo_video_id,
+        metadata,
         sidecar_data,
         visibility,
         _request_auth,
@@ -5560,8 +6934,13 @@ class AssetsApi:
     async def view_asset(
         self,
         id: UUID,
+        edited: Annotated[
+            Optional[StrictBool], Field(description="Return edited asset if available")
+        ] = None,
         key: Optional[StrictStr] = None,
-        size: Optional[AssetMediaSize] = None,
+        size: Annotated[
+            Optional[AssetMediaSize], Field(description="Asset media size")
+        ] = None,
         slug: Optional[StrictStr] = None,
         _request_timeout: Union[
             None,
@@ -5577,13 +6956,15 @@ class AssetsApi:
     ) -> bytearray:
         """View asset thumbnail
 
-        Retrieve the thumbnail image for the specified asset.
+        Retrieve the thumbnail image for the specified asset. Viewing the fullsize thumbnail might redirect to downloadAsset, which requires a different permission.
 
         :param id: (required)
         :type id: UUID
+        :param edited: Return edited asset if available
+        :type edited: bool
         :param key:
         :type key: str
-        :param size:
+        :param size: Asset media size
         :type size: AssetMediaSize
         :param slug:
         :type slug: str
@@ -5611,6 +6992,7 @@ class AssetsApi:
 
         _param = self._view_asset_serialize(
             id=id,
+            edited=edited,
             key=key,
             size=size,
             slug=slug,
@@ -5636,8 +7018,13 @@ class AssetsApi:
     async def view_asset_with_http_info(
         self,
         id: UUID,
+        edited: Annotated[
+            Optional[StrictBool], Field(description="Return edited asset if available")
+        ] = None,
         key: Optional[StrictStr] = None,
-        size: Optional[AssetMediaSize] = None,
+        size: Annotated[
+            Optional[AssetMediaSize], Field(description="Asset media size")
+        ] = None,
         slug: Optional[StrictStr] = None,
         _request_timeout: Union[
             None,
@@ -5653,13 +7040,15 @@ class AssetsApi:
     ) -> ApiResponse[bytearray]:
         """View asset thumbnail
 
-        Retrieve the thumbnail image for the specified asset.
+        Retrieve the thumbnail image for the specified asset. Viewing the fullsize thumbnail might redirect to downloadAsset, which requires a different permission.
 
         :param id: (required)
         :type id: UUID
+        :param edited: Return edited asset if available
+        :type edited: bool
         :param key:
         :type key: str
-        :param size:
+        :param size: Asset media size
         :type size: AssetMediaSize
         :param slug:
         :type slug: str
@@ -5687,6 +7076,7 @@ class AssetsApi:
 
         _param = self._view_asset_serialize(
             id=id,
+            edited=edited,
             key=key,
             size=size,
             slug=slug,
@@ -5712,8 +7102,13 @@ class AssetsApi:
     async def view_asset_without_preload_content(
         self,
         id: UUID,
+        edited: Annotated[
+            Optional[StrictBool], Field(description="Return edited asset if available")
+        ] = None,
         key: Optional[StrictStr] = None,
-        size: Optional[AssetMediaSize] = None,
+        size: Annotated[
+            Optional[AssetMediaSize], Field(description="Asset media size")
+        ] = None,
         slug: Optional[StrictStr] = None,
         _request_timeout: Union[
             None,
@@ -5729,13 +7124,15 @@ class AssetsApi:
     ) -> RESTResponseType:
         """View asset thumbnail
 
-        Retrieve the thumbnail image for the specified asset.
+        Retrieve the thumbnail image for the specified asset. Viewing the fullsize thumbnail might redirect to downloadAsset, which requires a different permission.
 
         :param id: (required)
         :type id: UUID
+        :param edited: Return edited asset if available
+        :type edited: bool
         :param key:
         :type key: str
-        :param size:
+        :param size: Asset media size
         :type size: AssetMediaSize
         :param slug:
         :type slug: str
@@ -5763,6 +7160,7 @@ class AssetsApi:
 
         _param = self._view_asset_serialize(
             id=id,
+            edited=edited,
             key=key,
             size=size,
             slug=slug,
@@ -5783,6 +7181,7 @@ class AssetsApi:
     def _view_asset_serialize(
         self,
         id,
+        edited,
         key,
         size,
         slug,
@@ -5808,6 +7207,9 @@ class AssetsApi:
         if id is not None:
             _path_params["id"] = id
         # process the query parameters
+        if edited is not None:
+            _query_params.append(("edited", edited))
+
         if key is not None:
             _query_params.append(("key", key))