@wix/auto_sdk_media_files 1.0.76 → 1.0.78

package/build/es/index.typings.d.mts

@@ -479,6 +479,183 @@ declare enum IdentityType {
 }
 /** @enumType */
 type IdentityTypeWithLiterals = IdentityType | 'UNKNOWN' | 'ANONYMOUS_VISITOR' | 'MEMBER' | 'WIX_USER' | 'APP';
+/**
+ * Internal-only metadata preserved from the raw PM contract that has no
+ * representation in the domain model. Populated during toDomain and used
+ * by fromDomain to reconstruct a lossless raw PM file.
+ */
+interface FileAdditionalProperties extends FileAdditionalPropertiesMediaAdditionalPropertiesOneOf {
+    /** Set when the file is an audio file; preserves PM-specific audio fields. */
+    audio?: AudioAdditionalProperties;
+    /** Set when the file is a video file; preserves PM-specific video fields. */
+    video?: VideoAdditionalProperties;
+    /** Set when the file is a font file; preserves PM-specific font fields. */
+    font?: FontAdditionalProperties;
+    /** Set when the file is a document file; preserves PM-specific document fields. */
+    document?: DocumentAdditionalProperties;
+    /** Set when the file is a 3D model file; preserves PM-specific model3d fields. */
+    model3d?: Model3dAdditionalProperties;
+    /** Set when the file is an image file; preserves PM-specific image fields. */
+    image?: ImageAdditionalProperties;
+}
+/** @oneof */
+interface FileAdditionalPropertiesMediaAdditionalPropertiesOneOf {
+    /** Set when the file is an audio file; preserves PM-specific audio fields. */
+    audio?: AudioAdditionalProperties;
+    /** Set when the file is a video file; preserves PM-specific video fields. */
+    video?: VideoAdditionalProperties;
+    /** Set when the file is a font file; preserves PM-specific font fields. */
+    font?: FontAdditionalProperties;
+    /** Set when the file is a document file; preserves PM-specific document fields. */
+    document?: DocumentAdditionalProperties;
+    /** Set when the file is a 3D model file; preserves PM-specific model3d fields. */
+    model3d?: Model3dAdditionalProperties;
+    /** Set when the file is an image file; preserves PM-specific image fields. */
+    image?: ImageAdditionalProperties;
+}
+interface AudioAdditionalProperties {
+    /** From PmAudioInfo.file_input.sample_rate, in Hz (e.g. 44100). */
+    sampleRate?: number | null;
+    /** From PmAudioInfo.file_input.channels (e.g. 2 for stereo). */
+    channels?: number | null;
+    /**
+     * Parallel array to AudioV2.assets, same sort order.
+     * @maxSize 10
+     */
+    assets?: AudioAssetAdditionalProperties[];
+}
+interface AudioAssetAdditionalProperties {
+    /**
+     * From PmAudioInfo.file_output.audio[].tag (e.g. "high").
+     * @maxLength 100
+     */
+    tag?: string | null;
+    /** From PmAudioInfo.file_output.audio[].audio_bitrate, in bits per second. */
+    audioBitrate?: number | null;
+    /**
+     * From PmAudioInfo.file_output.audio[].status (e.g. "READY").
+     * @maxLength 30
+     */
+    status?: string | null;
+    /**
+     * From PmAudioInfo.file_output.audio[].url (only populated for secure assets where PM omits the URL).
+     * @format WEB_URL
+     */
+    url?: string | null;
+}
+interface VideoAdditionalProperties {
+    /**
+     * From PmVideoInfo.file_input.fps (e.g. "25/1").
+     * @maxLength 10
+     */
+    fps?: string | null;
+    /** From PmVideoInfo.file_input.video_bitrate, in bits per second. */
+    videoBitrate?: number | null;
+    /** From PmVideoInfo.file_input.rotation, in degrees (e.g. 0, 90, 180, 270). */
+    rotation?: number | null;
+    /**
+     * From PmVideoInfo.file_input.display_aspect_ratio (e.g. "16:9").
+     * @maxLength 10
+     */
+    displayAspectRatio?: string | null;
+    /** From PmVideoInfo.file_input.audio_bitrate, in bits per second. */
+    audioBitrate?: number | null;
+    /**
+     * From PmVideoInfo.file_input.sample_aspect_ration (e.g. "1:1").
+     * @maxLength 10
+     */
+    sampleAspectRatio?: string | null;
+    /**
+     * Keyed by VideoResolution.assetKey (e.g. "720p.mp4", "storyboard-00001.jpg").
+     * Covers both file_output.video[] and file_output.storyboard[] on the raw side.
+     */
+    resolutions?: Record<string, VideoResolutionAdditionalProperties>;
+    /**
+     * Parallel array to VideoV2.posters, same sort order.
+     * @maxSize 10
+     */
+    posters?: ImageOutputAdditionalProperties[];
+}
+interface VideoResolutionAdditionalProperties {
+    /** From PmVideoInfo.file_output.video[].audio_bitrate or storyboard[].audio_bitrate, in bits per second. */
+    audioBitrate?: number | null;
+    /**
+     * From PmVideoInfo.file_output.video[].display_aspect_ratio or storyboard[].display_aspect_ratio (e.g. "16:9").
+     * @maxLength 10
+     */
+    displayAspectRatio?: string | null;
+    /**
+     * From PmVideoInfo.file_output.video[].fps or storyboard[].fps (e.g. "25/1").
+     * @maxLength 10
+     */
+    fps?: string | null;
+    /**
+     * From PmVideoInfo.file_output.video[].status or storyboard[].status (e.g. "READY").
+     * @maxLength 20
+     */
+    status?: string | null;
+    /**
+     * From PmVideoInfo.file_output.video[].tag or storyboard[].tag (e.g. "HD").
+     * @maxLength 100
+     */
+    tag?: string | null;
+    /** From PmVideoInfo.file_output.video[].video_bitrate or storyboard[].video_bitrate, in bits per second. */
+    videoBitrate?: number | null;
+}
+/**
+ * Shared additional properties for any ImageOutput in the raw PM contract
+ * (video poster outputs and preview outputs for document/model3d/image files).
+ */
+interface ImageOutputAdditionalProperties {
+    /**
+     * From ImageOutput.key (e.g. "poster.0", "image.preview").
+     * @maxLength 100
+     */
+    key?: string | null;
+    /** From ImageOutput.secure. */
+    secure?: boolean | null;
+    /**
+     * From ImageOutput.status (e.g. "READY").
+     * @maxLength 30
+     */
+    status?: string | null;
+    /**
+     * From ImageOutput.format (e.g. "jpg", "png"). Absent when original raw had no format field.
+     * @maxLength 10
+     */
+    format?: string | null;
+    /**
+     * From ImageOutput.name. Present for model3d and some document previews; absent for video posters.
+     * @maxLength 200
+     */
+    name?: string | null;
+}
+interface FontAdditionalProperties {
+    /**
+     * Parallel array to FontMedia.assets, same sort order.
+     * @maxSize 10
+     */
+    assets?: FontAssetAdditionalProperties[];
+}
+interface FontAssetAdditionalProperties {
+    /**
+     * From PmFontInfo.file_output.font[].status (e.g. "READY").
+     * @maxLength 30
+     */
+    status?: string | null;
+}
+interface DocumentAdditionalProperties {
+    /** From PmDocumentInfo.file_output.image[] preview entry; preserves raw PM image-output metadata. */
+    preview?: ImageOutputAdditionalProperties;
+}
+interface Model3dAdditionalProperties {
+    /** From PmModel3dInfo.file_output.image[] preview entry; preserves raw PM image-output metadata. */
+    preview?: ImageOutputAdditionalProperties;
+}
+interface ImageAdditionalProperties {
+    /** From PmImageInfo.file_output.image[] preview entry; preserves raw PM image-output metadata. */
+    preview?: ImageOutputAdditionalProperties;
+}
 interface DraftFilePublished {
     /** The file after it was published */
     file?: FileDescriptor;
@@ -609,7 +786,7 @@ interface GenerateFilesDownloadUrlRequest {
      * IDs of the files to download.
      *
      * You can also specify the files' Wix media URLs. For example, `["wix:image://v1/0abec0_b291a9349a0b4da59067f76287e386fb~mv2.jpg/leon.jpg#originWidth=3024&originHeight=4032"]`.
-     * Learn more about the [file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
+     * Learn more [about the file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
      * @minSize 1
      * @maxSize 1000
      * @maxLength 1000
@@ -628,7 +805,7 @@ interface GenerateFileDownloadUrlRequest {
      * File ID.
      *
      * You can also specify the file's Wix media URL. For example, `wix:image://v1/0abec0_b291a9349a0b4da59067f76287e386fb~mv2.jpg/leon.jpg#originWidth=3024&originHeight=4032`.
-     * Learn more about the [file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
+     * Learn more [about the file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
      * @maxLength 1000
      */
     fileId: string;
@@ -717,7 +894,7 @@ interface GetFileDescriptorRequest {
      * File ID.
      *
      * You can also specify the file's Wix media URL. For example, `wix:image://v1/0abec0_b291a9349a0b4da59067f76287e386fb~mv2.jpg/leon.jpg#originWidth=3024&originHeight=4032`.
-     * Learn more about the [file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
+     * Learn more [about the file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
      *
      * If you are working in REST, note that you must encode the Wix media URL to specify it as a query param because it contains special characters. For example, `wix:image://v1/0abec0_b291a9349a0b4da59067f76287e386fb~mv2.jpg/leon.jpg#originWidth=3024&originHeight=4032` becomes `wix%3Aimage%3A%2F%2Fv1%2F0abec0_b291a9349a0b4da59067f76287e386fb~mv2.jpg%2Fleon.jpg%23originWidth%3D3024%26originHeight%3D4032`.
      * @maxLength 1000
@@ -733,7 +910,7 @@ interface GetFileDescriptorsRequest {
      * File IDs.
      *
      * You can also specify the files' Wix media URLs. For example, `["wix:image://v1/0abec0_b291a9349a0b4da59067f76287e386fb~mv2.jpg/leon.jpg#originWidth=3024&originHeight=4032"]`.
-     * Learn more about the [file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
+     * Learn more [about the file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
      * @minSize 1
      * @maxSize 100
      * @maxLength 1000
@@ -819,7 +996,7 @@ interface GenerateFileUploadUrlRequest {
      * @maxLength 100
      */
     parentFolderId?: string | null;
-    /** Whether the file will be public or private. Learn more about [private files](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files). */
+    /** Whether the file will be public or private. Learn more [about private files](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/private-files). */
     private?: boolean | null;
     /**
      * Labels assigned to media files that describe and categorize them. Provided by the Wix user, or generated by [Google Vision API](https://cloud.google.com/vision/docs/drag-and-drop) for images.
@@ -930,7 +1107,7 @@ interface GenerateFileResumableUploadUrlRequest {
      * @maxLength 100
      */
     parentFolderId?: string | null;
-    /** Whether the file will be public or private. Learn more about [private files](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files). */
+    /** Whether the file will be public or private. Learn more [about private files](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/private-files). */
     private?: boolean | null;
     /**
      * Labels assigned to media files that describe and categorize them. Provided by the Wix user, or generated by [Google Vision API](https://cloud.google.com/vision/docs/drag-and-drop) for images.
@@ -993,7 +1170,7 @@ interface ImportFileRequest {
      * @maxLength 100
      */
     parentFolderId?: string | null;
-    /** Whether the file will be public or private. Learn more about [private files](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files). */
+    /** Whether the file will be public or private. Learn more [about private files](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/private-files). */
     private?: boolean | null;
     /**
      * Labels assigned to media files that describe and categorize them. Provided by the Wix user, or generated by [Google Vision API](https://cloud.google.com/vision/docs/drag-and-drop) for images.
@@ -1206,7 +1383,7 @@ interface SearchFilesRequest {
      * + `false`: Returns only public files.
      * + `undefined`: Returns public and private files.
      *
-     * Learn more about [private files](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files).
+     * Learn more [about private files](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/private-files).
      */
     private?: boolean | null;
     /**
@@ -1249,7 +1426,7 @@ interface GenerateVideoStreamingUrlRequest {
      * File ID.
      *
      * You can also specify the file's Wix media URL. For example, `wix:image://v1/0abec0_b291a9349a0b4da59067f76287e386fb~mv2.jpg/leon.jpg#originWidth=3024&originHeight=4032`.
-     * Learn more about the [file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
+     * Learn more [about the file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
      * @maxLength 1000
      */
     fileId: string;
@@ -1281,7 +1458,7 @@ interface BulkDeleteFilesRequest {
      * IDs of the files to move to the Media Manager's trash bin.
      *
      * You can also specify the files' Wix media URLs. For example, `["wix:image://v1/0abec0_b291a9349a0b4da59067f76287e386fb~mv2.jpg/leon.jpg#originWidth=3024&originHeight=4032"]`.
-     * Learn more about the [file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
+     * Learn more [about the file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
      * @maxSize 1000
      * @maxLength 1000
      */
@@ -1299,7 +1476,7 @@ interface BulkRestoreFilesFromTrashBinRequest {
      * IDs of the files to restore from the Media Manager's trash bin.
      *
      * You can also specify the files' Wix media URLs. For example, `["wix:image://v1/0abec0_b291a9349a0b4da59067f76287e386fb~mv2.jpg/leon.jpg#originWidth=3024&originHeight=4032"]`.
-     * Learn more about the [file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
+     * Learn more [about the file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
      * @maxSize 1000
      * @maxLength 1000
      */
@@ -1319,7 +1496,7 @@ interface ListDeletedFilesRequest {
      * @maxSize 30
      */
     mediaTypes?: MediaTypeWithLiterals[];
-    /** \n`true`: Returns only private files. \n`false`: Returns only public files. \n`undefined`: Returns public and private files. \n Learn more about [private files](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files). */
+    /** \n`true`: Returns only private files. \n`false`: Returns only public files. \n`undefined`: Returns public and private files. \n Learn more [about private files](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/private-files). */
     private?: boolean | null;
     /**
      * Field name and order to sort by. One of: <br />
@@ -1346,7 +1523,7 @@ interface BulkPublishDraftFilesRequest {
      * IDs of the draft files to be published.
      *
      * You can also specify the files' Wix media URLs. For example, `["wix:image://v1/0abec0_b291a9349a0b4da59067f76287e386fb~mv2.jpg/leon.jpg#originWidth=3024&originHeight=4032"]`.
-     * Learn more about the [file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
+     * Learn more [about the file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
      * @maxSize 100
      * @maxLength 1000
      */
@@ -1394,7 +1571,7 @@ interface UpdateFileRequest {
      * ID of the file to update.
      *
      * You can also specify the file's Wix media URL. For example, `wix:image://v1/0abec0_b291a9349a0b4da59067f76287e386fb~mv2.jpg/leon.jpg#originWidth=3024&originHeight=4032`.
-     * Learn more about the [file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
+     * Learn more [about the file ID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id).
      * @maxLength 1000
      */
     fileId?: string;
@@ -1421,7 +1598,12 @@ interface UpdateFileResponse {
     file?: FileDescriptor;
 }
 interface QueryFileDescriptorsRequest {
-    /** Query object */
+    /**
+     * Query options, including filter, sort, and cursor paging.
+     *
+     * See [API Query Language](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language) and
+     * [Sorting and Paging](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-sorting-and-paging) for more information.
+     */
     query?: CursorQuery;
 }
 interface CursorQuery extends CursorQueryPagingMethodOneOf {
@@ -1460,7 +1642,11 @@ interface Sorting {
      * @maxLength 512
      */
     fieldName?: string;
-    /** Sort order. */
+    /**
+     * Sort order. Use `ASC` for ascending order or `DESC` for descending order.
+     *
+     * Default: `ASC`
+     */
     order?: SortOrderWithLiterals;
 }
 declare enum SortOrder {
@@ -1471,11 +1657,11 @@ declare enum SortOrder {
 type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
 interface QueryFileDescriptorsResponse {
     /**
-     * The retrieved files that match the query
+     * Retrieved files that match the query.
      * @maxSize 200
      */
     files?: FileDescriptor[];
-    /** The metadata for the page including the next cursor if one exist */
+    /** Paging metadata, including the cursors for the next and previous pages. */
     pagingMetadata?: PagingMetadataV2;
 }
 interface ListRecentItemsRequest {
@@ -1963,9 +2149,9 @@ declare function updateFileDescriptor(file: NonNullablePaths<FileDescriptor, `_i
 /**
  * Generates an upload URL to allow external clients to upload a file to the Media Manager. <br/>
  *
- * To learn how external clients can use the generated upload URL in the response to upload a file to the Media Manager, see the [Upload API](https://dev.wix.com/docs/rest/assets/media/media-manager/files/upload-api).
+ * Learn how to use the generated upload URL to [upload a file to the Media Manager](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/upload-api).
  * > **Notes:**
- * > - When you upload a file, it's not immediately available, meaning you can't manage or use the file straight away. Learn more about [knowing when a file is ready](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/importing-files#knowing-when-a-file-is-ready).
+ * > - When you upload a file, it's not immediately available, meaning you can't manage or use the file straight away. Learn more about [knowing when a file is ready](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/importing-files).
  * > - Any interruption in the upload process stops the file upload. For files larger than 10MB, or when network connection is poor, call Generate File Resumable Upload URL instead. With the resumable upload URL, any interruption in the upload process pauses the file upload, and resumes the file upload process after the interruption.
  * @param mimeType - File mime type.
  * @public
@@ -1999,7 +2185,7 @@ interface GenerateFileUploadUrlOptions {
      * @maxLength 100
      */
     parentFolderId?: string | null;
-    /** Whether the file will be public or private. Learn more about [private files](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files). */
+    /** Whether the file will be public or private. Learn more [about private files](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/private-files). */
     private?: boolean | null;
     /**
      * Labels assigned to media files that describe and categorize them. Provided by the Wix user, or generated by [Google Vision API](https://cloud.google.com/vision/docs/drag-and-drop) for images.
@@ -2022,7 +2208,7 @@ interface GenerateFileUploadUrlOptions {
  * Generates a resumable upload URL to allow external clients to easily upload large files over 10MB to the Media Manager. <br/>
  *
  * With the resumable upload URL, any interruptions in the upload process pauses the file upload, and resumes the file upload process after the interruption. The resumable upload URL is also helpful when network connection is poor.
- * To learn how external clients can use the generated upload URL in the response to upload large files to the Media Manager, see [Resumable Upload API](https://dev.wix.com/docs/rest/assets/media/media-manager/files/resumable-upload-api).
+ * Learn how to use the generated upload URL in the response to [upload large files to the Media Manager](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/resumable-upload-api).
  *
  * > **Note:** When you upload a file, it's not immediately available, meaning you can't manage or use the file straight away. Learn more about [knowing when a file is ready](https://dev.wix.com/docs/rest/assets/media/media-manager/files/importing-files#knowing-when-a-file-is-ready).
  * @param mimeType - File mime type.
@@ -2057,7 +2243,7 @@ interface GenerateFileResumableUploadUrlOptions {
      * @maxLength 100
      */
     parentFolderId?: string | null;
-    /** Whether the file will be public or private. Learn more about [private files](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files). */
+    /** Whether the file will be public or private. Learn more [about private files](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/private-files). */
     private?: boolean | null;
     /**
      * Labels assigned to media files that describe and categorize them. Provided by the Wix user, or generated by [Google Vision API](https://cloud.google.com/vision/docs/drag-and-drop) for images.
@@ -2121,7 +2307,7 @@ interface ImportFileOptions {
      * @maxLength 100
      */
     parentFolderId?: string | null;
-    /** Whether the file will be public or private. Learn more about [private files](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files). */
+    /** Whether the file will be public or private. Learn more [about private files](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/private-files). */
     private?: boolean | null;
     /**
      * Labels assigned to media files that describe and categorize them. Provided by the Wix user, or generated by [Google Vision API](https://cloud.google.com/vision/docs/drag-and-drop) for images.
@@ -2159,7 +2345,7 @@ interface ImportFileOptions {
  *
  * >**Notes:**
  * > - The `media` property isn't returned in the `files` response object.
- * > - When you import a file, it's not immediately available, meaning you can't manage or use the file straight away. Learn more about [knowing when a file is ready](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/importing-files#knowing-when-a-file-is-ready).
+ * > - When you import a file, it's not immediately available, meaning you can't manage or use the file straight away. Learn more about [knowing when a file is ready](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/importing-files).
  *
  * To import files, you need to do one of the following for each file:
  * - Specify its [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) in the `mimeType` field of the request. For example, `mimeType: 'image/jpeg'`.
@@ -2189,7 +2375,7 @@ declare function bulkImportFiles(importFileRequests: NonNullablePaths<ImportFile
  *
  * >**Notes:**
  * > - The `media` property isn't returned in the `files` response object.
- * > - When you import a file, it's not immediately available, meaning you can't manage or use the file straight away. Learn more about [knowing when a file is ready](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/importing-files#knowing-when-a-file-is-ready).
+ * > - When you import a file, it's not immediately available, meaning you can't manage or use the file straight away. Learn more about [knowing when a file is ready](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/importing-files).
  *
  * To import files, you need to do one of the following for each file:
  * - Specify its [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) in the `mimeType` field of the request. For example, `mimeType: 'image/jpeg'`.
@@ -2314,7 +2500,7 @@ interface SearchFilesOptions {
      * + `false`: Returns only public files.
      * + `undefined`: Returns public and private files.
      *
-     * Learn more about [private files](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files).
+     * Learn more [about private files](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/private-files).
      */
     private?: boolean | null;
     /**
@@ -2419,7 +2605,7 @@ interface ListDeletedFilesOptions {
      * @maxSize 30
      */
     mediaTypes?: MediaTypeWithLiterals[];
-    /** \n`true`: Returns only private files. \n`false`: Returns only public files. \n`undefined`: Returns public and private files. \n Learn more about [private files](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files). */
+    /** \n`true`: Returns only private files. \n`false`: Returns only public files. \n`undefined`: Returns public and private files. \n Learn more [about private files](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/private-files). */
     private?: boolean | null;
     /**
      * Field name and order to sort by. One of: <br />
@@ -2433,14 +2619,15 @@ interface ListDeletedFilesOptions {
     paging?: CursorPaging;
 }
 /**
- * Retrieves a list of files in the Media Manager, given the provided [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging), filtering, and sorting.
+ * Retrieves a list of files in the Media Manager, given the provided [cursor paging](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language#cursor-paging), filtering, and sorting.
  *
  * Up to 200 files can be returned per request.
+ *
  * When filtering by `mediaType`, supported values are: `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT`, `VECTOR`, `ARCHIVE`, and `MODEL3D`.
  *
  * To learn about working with *Query* methods, see
- * [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language) and
- * [Sorting and Paging](https://dev.wix.com/docs/rest/articles/getting-started/sorting-and-paging).
+ * [API Query Language](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language) and
+ * [Sorting and Paging](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-sorting-and-paging).
  * @public
  * @permissionId media:site_media:v1:file_descriptor:query_file_descriptors
  * @applicableIdentity APP
@@ -2558,7 +2745,9 @@ type FileDescriptorQuery = {
       */
         fieldName?: NonNullable<CommonQueryWithEntityContext['sort']>[number]['fieldName'];
         /**
-      Sort order.
+      Sort order. Use `ASC` for ascending order or `DESC` for descending order.
+    
+      Default: `ASC`
       */
         order?: NonNullable<CommonQueryWithEntityContext['sort']>[number]['order'];
     }[];
@@ -2571,4 +2760,4 @@ declare const utils: {
     };
 };
 
-export { type AccountInfo, type AccountInfoMetadata, type ActionEvent, type ApplicationError, type Archive, type AudioV2, type BaseEventMetadata, type BulkActionMetadata, type BulkAnnotateImageResult, type BulkAnnotateImagesRequest, type BulkAnnotateImagesResponse, type BulkDeleteFilesOptions, type BulkDeleteFilesRequest, type BulkDeleteFilesResponse, type BulkImportFileOptions, type BulkImportFileRequest, type BulkImportFileResponse, type BulkImportFileResult, type BulkImportFilesRequest, type BulkImportFilesResponse, type BulkInternalImportFilesRequest, type BulkInternalImportFilesResponse, type BulkPublishDraftFileResult, type BulkPublishDraftFilesRequest, type BulkPublishDraftFilesResponse, type BulkRestoreFilesFromTrashBinRequest, type BulkRestoreFilesFromTrashBinResponse, type Color, type ColorRGB, type Colors, type CommonQueryWithEntityContext, CommonSortOrder, type CommonSortOrderWithLiterals, type CommonSorting, ContentDisposition, type ContentDispositionWithLiterals, type CursorPaging, type CursorQuery, type CursorQueryPagingMethodOneOf, type Cursors, type DomainEvent, type DomainEventBodyOneOf, type DownloadUrl, type DraftFilePublished, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type EventMetadata, type ExternalInfo, type FaceRecognition, type FileDescriptor, type FileDescriptorFileFailedEnvelope, type FileDescriptorFileReadyEnvelope, type FileDescriptorQuery, type FileDescriptorQuerySpec, type FileFailed, type FileMedia, type FileMediaMediaOneOf, type FileReady, type FilesQueryBuilder, type FilesQueryResult, type FocalPoint, type FontAsset, type FontMedia, type GenerateAnimatedVectorRequest, type GenerateAnimatedVectorResponse, type GenerateFileDownloadUrlOptions, type GenerateFileDownloadUrlRequest, type GenerateFileDownloadUrlResponse, type GenerateFileDownloadUrlValidationErrors, type GenerateFileResumableUploadUrlOptions, type GenerateFileResumableUploadUrlRequest, type GenerateFileResumableUploadUrlResponse, type GenerateFileResumableUploadUrlValidationErrors, type GenerateFileUploadUrlOptions, type GenerateFileUploadUrlRequest, type GenerateFileUploadUrlResponse, type GenerateFileUploadUrlValidationErrors, type GenerateFilesDownloadUrlRequest, type GenerateFilesDownloadUrlResponse, type GenerateVideoStreamingUrlOptions, type GenerateVideoStreamingUrlRequest, type GenerateVideoStreamingUrlResponse, type GenerateWebSocketTokenRequest, type GenerateWebSocketTokenResponse, type GetFileDescriptorRequest, type GetFileDescriptorResponse, type GetFileDescriptorValidationErrors, type GetFileDescriptorsRequest, type GetFileDescriptorsResponse, type GetFileDescriptorsValidationErrors, type GetSiteFileDescriptorsRequest, type GetSiteFileDescriptorsResponse, type IdentificationData, type IdentificationDataIdOneOf, type IdentityInfo, IdentityType, type IdentityTypeWithLiterals, type ImageAnnotationConfigurations, ImageAnnotationType, type ImageAnnotationTypeWithLiterals, type ImageMedia, type ImportFileOptions, type ImportFileRequest, type ImportFileResponse, type ImportFileValidationErrors, type ItemMetadata, type ListDeletedFilesOptions, type ListDeletedFilesRequest, type ListDeletedFilesResponse, type ListDeletedFilesValidationErrors, type ListFilesOptions, type ListFilesRequest, type ListFilesResponse, type ListFilesValidationErrors, type ListRecentItemsRequest, type ListRecentItemsResponse, MediaType, type MediaTypeWithLiterals, type MessageEnvelope, type Model3D, Namespace, type NamespaceWithLiterals, OperationStatus, type OperationStatusWithLiterals, type OtherMedia, type PagingMetadataV2, type Plan, type Plans, type QueryFileDescriptorsRequest, type QueryFileDescriptorsResponse, type RestoreInfo, RootFolder, type RootFolderWithLiterals, type SearchFilesOptions, type SearchFilesRequest, type SearchFilesResponse, type SearchFilesValidationErrors, type ServiceError, type SiteQuotaExceededError, SortOrder, type SortOrderWithLiterals, type Sorting, State, type StateWithLiterals, StreamFormat, type StreamFormatWithLiterals, type SyncImportFileDescriptorRequest, type SyncImportFileDescriptorResponse, type SyncImportFileRequest, type SyncImportFileResponse, type TotalQuota, type UnsupportedRequestValueError, type UpdateFileDescriptorRequest, type UpdateFileDescriptorResponse, type UpdateFileDescriptorValidationErrors, type UpdateFileRequest, type UpdateFileResponse, UploadProtocol, type UploadProtocolWithLiterals, type VideoResolution, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, bulkDeleteFiles, bulkImportFile, bulkImportFiles, bulkRestoreFilesFromTrashBin, generateFileDownloadUrl, generateFileResumableUploadUrl, generateFileUploadUrl, generateFilesDownloadUrl, generateVideoStreamingUrl, getFileDescriptor, getFileDescriptors, importFile, listDeletedFiles, listFiles, onFileDescriptorFileFailed, onFileDescriptorFileReady, queryFileDescriptors, searchFiles, typedQueryFileDescriptors, updateFileDescriptor, utils };
+export { type AccountInfo, type AccountInfoMetadata, type ActionEvent, type ApplicationError, type Archive, type AudioAdditionalProperties, type AudioAssetAdditionalProperties, type AudioV2, type BaseEventMetadata, type BulkActionMetadata, type BulkAnnotateImageResult, type BulkAnnotateImagesRequest, type BulkAnnotateImagesResponse, type BulkDeleteFilesOptions, type BulkDeleteFilesRequest, type BulkDeleteFilesResponse, type BulkImportFileOptions, type BulkImportFileRequest, type BulkImportFileResponse, type BulkImportFileResult, type BulkImportFilesRequest, type BulkImportFilesResponse, type BulkInternalImportFilesRequest, type BulkInternalImportFilesResponse, type BulkPublishDraftFileResult, type BulkPublishDraftFilesRequest, type BulkPublishDraftFilesResponse, type BulkRestoreFilesFromTrashBinRequest, type BulkRestoreFilesFromTrashBinResponse, type Color, type ColorRGB, type Colors, type CommonQueryWithEntityContext, CommonSortOrder, type CommonSortOrderWithLiterals, type CommonSorting, ContentDisposition, type ContentDispositionWithLiterals, type CursorPaging, type CursorQuery, type CursorQueryPagingMethodOneOf, type Cursors, type DocumentAdditionalProperties, type DomainEvent, type DomainEventBodyOneOf, type DownloadUrl, type DraftFilePublished, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type EventMetadata, type ExternalInfo, type FaceRecognition, type FileAdditionalProperties, type FileAdditionalPropertiesMediaAdditionalPropertiesOneOf, type FileDescriptor, type FileDescriptorFileFailedEnvelope, type FileDescriptorFileReadyEnvelope, type FileDescriptorQuery, type FileDescriptorQuerySpec, type FileFailed, type FileMedia, type FileMediaMediaOneOf, type FileReady, type FilesQueryBuilder, type FilesQueryResult, type FocalPoint, type FontAdditionalProperties, type FontAsset, type FontAssetAdditionalProperties, type FontMedia, type GenerateAnimatedVectorRequest, type GenerateAnimatedVectorResponse, type GenerateFileDownloadUrlOptions, type GenerateFileDownloadUrlRequest, type GenerateFileDownloadUrlResponse, type GenerateFileDownloadUrlValidationErrors, type GenerateFileResumableUploadUrlOptions, type GenerateFileResumableUploadUrlRequest, type GenerateFileResumableUploadUrlResponse, type GenerateFileResumableUploadUrlValidationErrors, type GenerateFileUploadUrlOptions, type GenerateFileUploadUrlRequest, type GenerateFileUploadUrlResponse, type GenerateFileUploadUrlValidationErrors, type GenerateFilesDownloadUrlRequest, type GenerateFilesDownloadUrlResponse, type GenerateVideoStreamingUrlOptions, type GenerateVideoStreamingUrlRequest, type GenerateVideoStreamingUrlResponse, type GenerateWebSocketTokenRequest, type GenerateWebSocketTokenResponse, type GetFileDescriptorRequest, type GetFileDescriptorResponse, type GetFileDescriptorValidationErrors, type GetFileDescriptorsRequest, type GetFileDescriptorsResponse, type GetFileDescriptorsValidationErrors, type GetSiteFileDescriptorsRequest, type GetSiteFileDescriptorsResponse, type IdentificationData, type IdentificationDataIdOneOf, type IdentityInfo, IdentityType, type IdentityTypeWithLiterals, type ImageAdditionalProperties, type ImageAnnotationConfigurations, ImageAnnotationType, type ImageAnnotationTypeWithLiterals, type ImageMedia, type ImageOutputAdditionalProperties, type ImportFileOptions, type ImportFileRequest, type ImportFileResponse, type ImportFileValidationErrors, type ItemMetadata, type ListDeletedFilesOptions, type ListDeletedFilesRequest, type ListDeletedFilesResponse, type ListDeletedFilesValidationErrors, type ListFilesOptions, type ListFilesRequest, type ListFilesResponse, type ListFilesValidationErrors, type ListRecentItemsRequest, type ListRecentItemsResponse, MediaType, type MediaTypeWithLiterals, type MessageEnvelope, type Model3D, type Model3dAdditionalProperties, Namespace, type NamespaceWithLiterals, OperationStatus, type OperationStatusWithLiterals, type OtherMedia, type PagingMetadataV2, type Plan, type Plans, type QueryFileDescriptorsRequest, type QueryFileDescriptorsResponse, type RestoreInfo, RootFolder, type RootFolderWithLiterals, type SearchFilesOptions, type SearchFilesRequest, type SearchFilesResponse, type SearchFilesValidationErrors, type ServiceError, type SiteQuotaExceededError, SortOrder, type SortOrderWithLiterals, type Sorting, State, type StateWithLiterals, StreamFormat, type StreamFormatWithLiterals, type SyncImportFileDescriptorRequest, type SyncImportFileDescriptorResponse, type SyncImportFileRequest, type SyncImportFileResponse, type TotalQuota, type UnsupportedRequestValueError, type UpdateFileDescriptorRequest, type UpdateFileDescriptorResponse, type UpdateFileDescriptorValidationErrors, type UpdateFileRequest, type UpdateFileResponse, UploadProtocol, type UploadProtocolWithLiterals, type VideoAdditionalProperties, type VideoResolution, type VideoResolutionAdditionalProperties, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, bulkDeleteFiles, bulkImportFile, bulkImportFiles, bulkRestoreFilesFromTrashBin, generateFileDownloadUrl, generateFileResumableUploadUrl, generateFileUploadUrl, generateFilesDownloadUrl, generateVideoStreamingUrl, getFileDescriptor, getFileDescriptors, importFile, listDeletedFiles, listFiles, onFileDescriptorFileFailed, onFileDescriptorFileReady, queryFileDescriptors, searchFiles, typedQueryFileDescriptors, updateFileDescriptor, utils };