> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# ListFiles

# Package: mediaManager

# Namespace: FilesService

# Method link: https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/list-files.md

## Permission Scopes:
Read Media Manager: SCOPE.DC-MEDIA.READ-MEDIAMANAGER

## Introduction

Retrieves a list of files in the Media Manager.

To retrieve a list of files within a specific folder in the Media Manager, specify the folder's ID in the `parentFolderId` parameter. If no folder is specified, the method retrieves the list of files in the root folder of the Media Manager.

---

## REST API

### Schema

```
 Method: listFiles
 Description: Retrieves a list of files in the Media Manager.  To retrieve a list of files within a specific folder in the Media Manager, specify the folder's GUID in the `parentFolderId` parameter. If no folder is specified, the method retrieves the list of files in the root folder of the Media Manager.
 URL: https://www.wixapis.com/site-media/v1/files
 Method: GET
 Method parameters:
   query param name: mediaTypes | type: array<mediaTypes> | description: File media type. 
                 - enum: UNKNOWN, IMAGE, VIDEO, AUDIO, DOCUMENT, VECTOR, ARCHIVE, MODEL3D, OTHER
   param name: paging | type: CursorPaging   
        - name: limit | type: integer | description: Maximum number of items to return in the results. 
        - name: cursor | type: string | description: Pointer to the next or previous page in the list of results.  Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response. Not relevant for the first request. 
   query param name: parentFolderId | type: parentFolderId | description: GUID of the file's parent folder.  Default: `media-root`. 
   query param name: private | type: private | description: Whether to return only private or only public files. + `true`: Returns only private files. + `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.md). 
   param name: sort | type: Sorting   
        - name: fieldName | type: string | description: Name of the field to sort by. 
        - name: order | type: SortOrder | description: Sort order. 
             - enum: ASC, DESC
 Return type: ListFilesResponse
  - name: files | type: array<FileDescriptor> | description: List of files in the Media Manager. 
     - name: id | type: string | description: File GUID. Generated when a file is uploaded to the Media Manager. 
     - name: displayName | type: string | description: File name as it appears in the Media Manager. 
     - name: url | type: string | description: Static URL of the file. 
     - name: parentFolderId | type: string | description: GUID of the file's parent folder. 
     - name: hash | type: string | description: File hash. 
     - name: sizeInBytes | type: string | description: Size of the uploaded file in bytes. 
     - name: private | type: boolean | description: Whether the file is public or private. Learn more about [private files](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files.md). 
     - name: mediaType | type: MediaType | description: Media file type. 
         - enum: UNKNOWN, IMAGE, VIDEO, AUDIO, DOCUMENT, VECTOR, ARCHIVE, MODEL3D, OTHER
     - name: media | type: FileMedia | description: Media file content. 
        - ONE-OF: 
           - name: image | type: ImageMedia | description: Information about the image. 
              - name: image | type: Image | description: Image data. 
                 - name: id | type: string | description: WixMedia image GUID. 
                 - name: url | type: string | description: Image URL. 
                 - name: height | type: integer | description: Original image height. 
                 - name: width | type: integer | description: Original image width. 
                 - name: altText | type: string | description: Image alt text. 
                 - name: filename | type: string | description: Image filename. 
              - name: colors | type: Colors | description: Image colors. 
                 - name: prominent | type: Color | description: Main color of the image. 
                    - name: hex | type: string | description: HEX color. 
                    - name: rgb | type: ColorRGB | description: RGB color. 
                       - name: r | type: integer | description: Red channel. 
                       - name: g | type: integer | description: Green channel. 
                       - name: b | type: integer | description: Blue channel. 
                 - name: palette | type: array<Color> | description: Color palette of the image. 
              - name: faces | type: array<FaceRecognition> | description: Information about faces in the image. Use to crop images without cutting out faces. 
                 - name: confidence | type: number | description: The accuracy percentage of the face recognition. The likelihood that a face is detected. 
                 - name: x | type: integer | description: Top left x pixel coordinate of the face. 
                 - name: y | type: integer | description: Top left y pixel coordinate of the face. 
                 - name: height | type: integer | description: Face pixel height. 
                 - name: width | type: integer | description: Face pixel width. 
              - name: previewImage | type: Image | description: Information about the image preview. You can use this to display a preview for private images. 
              - name: caption | type: string | description: Optional, An AI generated description of the image 
           - name: video | type: VideoV2 | description: Information about the video. 
              - name: id | type: string | description: WixMedia GUID. 
              - name: resolutions | type: array<VideoResolution> | description: Available resolutions for the video, starting with the optimal resolution. 
                 - name: url | type: string | description: Video URL. 
                 - name: height | type: integer | description: Video height. 
                 - name: width | type: integer | description: Video width. 
                 - name: format | type: string | description: Video format Possible values: ['144p.mp4' '144p.webm' '240p.mp4' '240p.webm' '360p.mp4' '360p.webm' '480p.mp4' '480p.webm' '720p.mp4' '720p.webm' '1080p.mp4' '1080p.webm', 'hls' ] 
              - name: filename | type: string | description: Video filename. 
           - name: audio | type: AudioV2 | description: Information about the audio. 
              - name: id | type: string | description: WixMedia GUID. 
              - name: assets | type: array<Audio> | description: Audio formats available for this file. 
                 - name: id | type: string | description: WixMedia GUID. 
                 - name: url | type: string | description: Audio URL. 
                 - name: filename | type: string | description: Audio filename. 
              - name: bitrate | type: integer | description: Audio bitrate. 
              - name: format | type: string | description: Audio format. 
              - name: duration | type: integer | description: Audio duration in seconds. 
              - name: sizeInBytes | type: string | description: Audio size in bytes. 
           - name: document | type: Document | description: Information about the document. 
              - name: id | type: string | description: WixMedia GUID. 
              - name: url | type: string | description: Document URL. 
              - name: filename | type: string | description: Document filename. 
           - name: vector | type: ImageMedia | description: Information about the vector. 
           - name: archive | type: Archive | description: Information about the archive. 
              - name: id | type: string | description: WixMedia GUID. 
              - name: url | type: string | description: Archive URL. 
              - name: urlExpirationDate | type: string | description: Archive URL expiration date (when relevant). 
              - name: sizeInBytes | type: string | description: Archive size in bytes. 
              - name: filename | type: string | description: Archive filename. 
           - name: model3d | type: Model3D | description: Information about the 3D Model. 
              - name: id | type: string | description: WixMedia 3D GUID. 
              - name: url | type: string | description: 3D URL. 
              - name: thumbnail | type: Image | description: 3D thumbnail Image 
              - name: altText | type: string | description: 3D alt text. 
              - name: urlExpirationDate | type: string | description: 3D URL expiration date (when relevant). 
              - name: filename | type: string | description: 3D filename. 
              - name: sizeInBytes | type: string | description: 3D size in bytes. 
     - name: operationStatus | type: OperationStatus | description: Status of the file that was uploaded. 
         - enum:
         -     FAILED: The file failed to upload, for example, during media post processing.
         -     READY: The file uploaded, finished all processing, and is ready for use.
         -     PENDING: The file is processing and the URLs are not yet available. This response is returned when importing a file.
     - name: sourceUrl | type: string | description: URL where the file was uploaded from. 
     - name: thumbnailUrl | type: string | description: URL of the file's thumbnail. 
     - name: labels | type: array | description: 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. 
     - name: createdDate | type: string | description: Date and time the file was created. 
     - name: updatedDate | type: string | description: Date and time the file was updated. 
     - name: siteId | type: string | description: The Wix site GUID where the media file is stored. 
     - name: state | type: State | description: State of the file. 
         - enum:
         -     OK: File is ready for consumption
         -     DELETED: Deleted file
  - name: nextCursor | type: PagingMetadataV2 | description: The next cursor if it exists. 
     - name: total | type: integer | description: Total number of items that match the query. Returned if offset paging is used and the `tooManyToCount` flag is not set. 
     - name: cursors | type: Cursors | description: Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used. 
        - name: next | type: string | description: Cursor string pointing to the next page in the list of results. 

 Possible Errors:
   HTTP Code: 400 | Status Code: INVALID_ARGUMENT | Application Code: UNSUPPORTED_SORT_VALUE | Description: Sort value isn't supported.
   HTTP Code: 400 | Status Code: INVALID_ARGUMENT | Application Code: UNSUPPORTED_MEDIA_TYPE | Description: Media type isn't supported for filtering.


```

### Examples

### List image files in a specific folder
This example sorts by `updatedDate` in `DESC` order with a paging limit of 2.

```curl
curl -X GET \
  'https://www.wixapis.com/site-media/v1/files?parentFolderId=25284aa06584441ea94338fdcfbaba12&sort.fieldName=updateDate&mediaTypes=IMAGE&sort.order=DESC&paging.limit=2' \
  -H 'Authorization: <AUTH>'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.mediaManager.FilesService.listFiles(options)
 Description: Retrieves a list of files in the Media Manager.  To retrieve a list of files within a specific folder in the Media Manager, specify the folder's GUID in the `parentFolderId` parameter. If no folder is specified, the method retrieves the list of files in the root folder of the Media Manager.
 Method parameters:
   param name: options | type: ListFilesOptions  none 
        - name: parentFolderId | type: string | description: GUID of the file's parent folder.  Default: `media-root`. 
        - name: mediaTypes | type: array<MediaType> | description: File media type. 
             - enum: UNKNOWN, IMAGE, VIDEO, AUDIO, DOCUMENT, VECTOR, ARCHIVE, MODEL3D, OTHER
        - name: private | type: boolean | description: Whether to return only private or only public files. + `true`: Returns only private files. + `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.md). 
        - name: sort | type: Sorting | description: Field name and order to sort by. One of:  `displayName` `updatedDate` `sizeInBytes`  Default: `updatedDate` in `desc` order. 
           - name: fieldName | type: string | description: Name of the field to sort by. 
           - name: order | type: SortOrder | description: Sort order. 
                 - enum: ASC, DESC
        - name: paging | type: CursorPaging | description: Cursor and paging information. 
           - name: limit | type: integer | description: Maximum number of items to return in the results. 
           - name: cursor | type: string | description: Pointer to the next or previous page in the list of results.  Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response. Not relevant for the first request. 
 Return type: PROMISE<ListFilesResponse>
  - name: files | type: array<FileDescriptor> | description: List of files in the Media Manager. 
     - name: _id | type: string | description: File GUID. Generated when a file is uploaded to the Media Manager. 
     - name: displayName | type: string | description: File name as it appears in the Media Manager. 
     - name: url | type: string | description: Static URL of the file. 
     - name: parentFolderId | type: string | description: GUID of the file's parent folder. 
     - name: hash | type: string | description: File hash. 
     - name: sizeInBytes | type: string | description: Size of the uploaded file in bytes. 
     - name: private | type: boolean | description: Whether the file is public or private. Learn more about [private files](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files.md). 
     - name: mediaType | type: MediaType | description: Media file type. 
         - enum: UNKNOWN, IMAGE, VIDEO, AUDIO, DOCUMENT, VECTOR, ARCHIVE, MODEL3D, OTHER
     - name: media | type: FileMedia | description: Media file content. 
        - ONE-OF: 
           - name: image | type: ImageMedia | description: Information about the image. 
              - name: image | type: string | description: Image data. 
              - name: colors | type: Colors | description: Image colors. 
                 - name: prominent | type: Color | description: Main color of the image. 
                    - name: hex | type: string | description: HEX color. 
                    - name: rgb | type: ColorRGB | description: RGB color. 
                       - name: r | type: integer | description: Red channel. 
                       - name: g | type: integer | description: Green channel. 
                       - name: b | type: integer | description: Blue channel. 
                 - name: palette | type: array<Color> | description: Color palette of the image. 
              - name: faces | type: array<FaceRecognition> | description: Information about faces in the image. Use to crop images without cutting out faces. 
                 - name: confidence | type: number | description: The accuracy percentage of the face recognition. The likelihood that a face is detected. 
                 - name: x | type: integer | description: Top left x pixel coordinate of the face. 
                 - name: y | type: integer | description: Top left y pixel coordinate of the face. 
                 - name: height | type: integer | description: Face pixel height. 
                 - name: width | type: integer | description: Face pixel width. 
              - name: previewImage | type: string | description: Information about the image preview. You can use this to display a preview for private images. 
              - name: caption | type: string | description: Optional, An AI generated description of the image 
           - name: video | type: string | description: Information about the video. 
           - name: audio | type: AudioV2 | description: Information about the audio. 
              - name: _id | type: string | description: WixMedia GUID. 
              - name: assets | type: array | description: Audio formats available for this file. 
              - name: bitrate | type: integer | description: Audio bitrate. 
              - name: format | type: string | description: Audio format. 
              - name: duration | type: integer | description: Audio duration in seconds. 
              - name: sizeInBytes | type: string | description: Audio size in bytes. 
           - name: document | type: string | description: Information about the document. 
           - name: vector | type: ImageMedia | description: Information about the vector. 
           - name: archive | type: Archive | description: Information about the archive. 
              - name: _id | type: string | description: WixMedia GUID. 
              - name: url | type: string | description: Archive URL. 
              - name: urlExpirationDate | type: Date | description: Archive URL expiration date (when relevant). 
              - name: sizeInBytes | type: string | description: Archive size in bytes. 
              - name: filename | type: string | description: Archive filename. 
           - name: model3d | type: Model3D | description: Information about the 3D Model. 
              - name: _id | type: string | description: WixMedia 3D GUID. 
              - name: url | type: string | description: 3D URL. 
              - name: thumbnail | type: string | description: 3D thumbnail Image 
              - name: altText | type: string | description: 3D alt text. 
              - name: urlExpirationDate | type: Date | description: 3D URL expiration date (when relevant). 
              - name: filename | type: string | description: 3D filename. 
              - name: sizeInBytes | type: string | description: 3D size in bytes. 
     - name: operationStatus | type: OperationStatus | description: Status of the file that was uploaded. 
         - enum:
         -     FAILED: The file failed to upload, for example, during media post processing.
         -     READY: The file uploaded, finished all processing, and is ready for use.
         -     PENDING: The file is processing and the URLs are not yet available. This response is returned when importing a file.
     - name: sourceUrl | type: string | description: URL where the file was uploaded from. 
     - name: thumbnailUrl | type: string | description: URL of the file's thumbnail. 
     - name: labels | type: array | description: 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. 
     - name: _createdDate | type: Date | description: Date and time the file was created. 
     - name: _updatedDate | type: Date | description: Date and time the file was updated. 
     - name: siteId | type: string | description: The Wix site GUID where the media file is stored. 
     - name: state | type: State | description: State of the file. 
         - enum:
         -     OK: File is ready for consumption
         -     DELETED: Deleted file
  - name: nextCursor | type: PagingMetadataV2 | description: The next cursor if it exists. 
     - name: total | type: integer | description: Total number of items that match the query. Returned if offset paging is used and the `tooManyToCount` flag is not set. 
     - name: cursors | type: Cursors | description: Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used. 
        - name: next | type: string | description: Cursor string pointing to the next page in the list of results. 

 Possible Errors:
   HTTP Code: 400 | Status Code: INVALID_ARGUMENT | Application Code: UNSUPPORTED_SORT_VALUE | Description: Sort value isn't supported.
   HTTP Code: 400 | Status Code: INVALID_ARGUMENT | Application Code: UNSUPPORTED_MEDIA_TYPE | Description: Media type isn't supported for filtering.


```

### Examples

### Update a file's display name from visitor input (with $w)
This code uses the visitor's input on the page to update the display name of an image which they choose from a dropdown list on the page.

```javascript
/****************************************
 * Backend code - update-file.web.js/ts *
 ***************************************/

import { Permissions, webMethod } from '@wix/web-methods';
import { files } from '@wix/media';
import { auth } from '@wix/essentials';

export const updateFile = webMethod(Permissions.Anyone, async (fileId, file) => {
  try {
    const elevatedUpdateFileDescriptor = auth.elevate(files.updateFileDescriptor);
    const updatedDescriptor = await elevatedUpdateFileDescriptor({
      _id: fileId, 
      ...file 
    });

    return updatedDescriptor;
  } catch (error) {
    console.error(error);
  }
});

export const listImages = webMethod(Permissions.Anyone, async () => {
  const listOptions = {
    mediaTypes: ["IMAGE"]
  }

  try {
    const elevatedListFiles = auth.elevate(files.listFiles)
    const images = await elevatedListFiles(listOptions);

    return images.files;
  } catch (error) {
    console.error(error);
  }
});

/*************
 * Page code *
 ************/

import { updateFile, listImages } from 'backend/update-file.web';

$w.onReady(async () => {
  await populateImagesDropdown();

  $w('#update').onClick(async () => {
    const imageId = $w('#imagesDropdown').value;

    const fileUpdates = {
      displayName: $w('#newDisplayName').value
    }

    const updatedLocation = await updateFile(imageId, fileUpdates);
    console.log('Display name successfully updated to:', updatedLocation.displayName)
    $w('#updateSuccessMsg').show();
  });
});

async function populateImagesDropdown() {
  const images = await listImages();
  const dropdownOptions = images.map((image) => {
    return {
      label: image.displayName,
      value: image._id
    };
  });

  $w('#imagesDropdown').options = dropdownOptions;
};

```

### Generate a download url for all images in media (with $w)
This is an example of a function running on page ready. The function lists all the images from media, and then uses their IDs to create a download url.

```javascript
/***********************************************
 * Backend code - download-files-url.web.js/ts *
 **********************************************/

import { Permissions, webMethod } from '@wix/web-methods';
import { files } from '@wix/media';
import { auth } from '@wix/essentials';

export const generateDownloadUrl = webMethod(Permissions.Anyone, async (fileIds) => {
  try {
    const elevatedGenerateFilesDownloadUrl = auth.elevate(files.generateFilesDownloadUrl)
    const generatedUrl = await elevatedGenerateFilesDownloadUrl(fileIds);

    return generatedUrl.downloadUrl;
  } catch (error) {
    console.error(error);
  }
});
  
export const listImages = webMethod(Permissions.Anyone, async () => {
  const listOptions = {
    mediaTypes: ["IMAGE"]
  }

  try {
    const elevatedListFiles = auth.elevate(files.listFiles)
    const images = await elevatedListFiles(listOptions);

    return images.files;
  } catch (error) {
    console.error(error);
  }
});

/*************
 * Page code *
 ************/

import { listImages, generateDownloadUrl } from 'backend/download-files-url.web';

$w.onReady(() => {
  $w('#downloadFiles').disable();
  getDownloadUrl();
});

async function getDownloadUrl() {
  const images = await listImages();

  const imageIds = images.map((image) => {
    return image._id;
  });
  const downloadUrl = await generateDownloadUrl(imageIds);

  $w('#downloadFiles').link = downloadUrl;
  await $w('#downloadFiles').enable();
}

```

### List files in a specific folder (with elevated permissions)
```javascript
import { files } from '@wix/media';
import { auth } from '@wix/essentials';

/* Sample listOptions value:
 * {
 *   parentFolderId : 'igje5u22nij3qkltzsnol37j3dnthvvh'
 * }
 */

export async function myListFilesFunction(listOptions) {
  try {
    const elevatedListFiles = auth.elevate(files.listFiles);
    const fileList = await elevatedListFiles(listOptions);

    console.log('Files in folder:', fileList);
    return fileList;
  } catch (error) {
    console.error(error);
    // Handle the error
  }
}

/* Promise resolves to:
 * {
 *   "files": [
 *     {
 *       "_createdDate": "2023-07-16T08:56:07.000Z",
 *       "_id": "w8ide0_f4dRFF610cKd7zkjVbaNddXgb181lXfg.pdf",
 *       "_updatedDate": "2023-07-16T08:56:07.000Z",
 *       "displayName": "file1.pdf",
 *       "hash": "z3bxokp79p04ok6iiu9ao8srx5lrynfh",
 *       "internalTags": [
 *         "_fileOrigin_uploaded"
 *       ],
 *       "labels": [],
 *       "media": {
 *         "document": "wix:document://v1/w8ide0_f4dRFF610cKd7zkjVbaNddXgb181lXfg.pdf/file1.pdf"
 *       },
 *       "mediaType": "DOCUMENT",
 *       "operationStatus": "READY",
 *       "parentFolderId": "igje5u22nij3qkltzsnol37j3dnthvvh",
 *       "private": false,
 *       "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *       "sizeInBytes": "187199",
 *       "state": "OK",
 *       "thumbnailUrl": "https://static.wixstatic.com/media/it7ucst133nc8d9e0ff4d0nay1ucksc6.png",
 *       "url": "https://3ecba886-4267-11ee-be56-0242ac120002.usrfiles.com/ugd/w8ide0_f4dRFF610cKd7zkjVbaNddXgb181lXfg.pdf"
 *     },
 *     {
 *       "_createdDate": "2023-07-16T08:56:07.000Z",
 *       "_id": "w8ide0_170y03n3akmstnpt5jmsju89wvgs9tg4.pdf",
 *       "_updatedDate": "2023-07-16T08:56:07.000Z",
 *       "displayName": "file2.pdf",
 *       "hash": "g6x41coggaystn596ndb09q1ecg036gk",
 *       "internalTags": [
 *         "_fileOrigin_uploaded"
 *       ],
 *       "labels": [],
 *       "media": {
 *         "document": "wix:document://v1/w8ide0_170y03n3akmstnpt5jmsju89wvgs9tg4.pdf/file2.pdf"
 *       },
 *       "mediaType": "DOCUMENT",
 *       "operationStatus": "READY",
 *       "parentFolderId": "igje5u22nij3qkltzsnol37j3dnthvvh",
 *       "private": false,
 *       "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *       "sizeInBytes": "81624",
 *       "state": "OK",
 *       "thumbnailUrl": "https://static.wixstatic.com/media/it7ucst133nc8d9e0ff4d0nay1ucksc6.png",
 *       "url": "https://3ecba886-4267-11ee-be56-0242ac120002.usrfiles.com/ugd/w8ide0_170y03n3akmstnpt5jmsju89wvgs9tg4.pdf"
 *     }
 *   ],
 *   "nextCursor": {
 *     "cursors": {
 *       "next": ""
 *     },
 *     "hasNext": false
 *   }
 * }
 */
```

### List files in a specific folder
```javascript
import { files } from '@wix/media';

/* Sample listOptions value:
 * {
 *   parentFolderId : 'igje5u22nij3qkltzsnol37j3dnthvvh'
 * }
 */

export async function myListFilesFunction(listOptions) {
  try {
    const fileList = await files.listFiles(listOptions);

    console.log('Files in folder:', fileList);
    return fileList;
  } catch (error) {
    console.error(error);
    // Handle the error
  }
}

/* Promise resolves to:
 * {
 *   "files": [
 *     {
 *       "_createdDate": "2023-07-16T08:56:07.000Z",
 *       "_id": "w8ide0_f4dRFF610cKd7zkjVbaNddXgb181lXfg.pdf",
 *       "_updatedDate": "2023-07-16T08:56:07.000Z",
 *       "displayName": "file1.pdf",
 *       "hash": "z3bxokp79p04ok6iiu9ao8srx5lrynfh",
 *       "internalTags": [
 *         "_fileOrigin_uploaded"
 *       ],
 *       "labels": [],
 *       "media": {
 *         "document": "wix:document://v1/w8ide0_f4dRFF610cKd7zkjVbaNddXgb181lXfg.pdf/file1.pdf"
 *       },
 *       "mediaType": "DOCUMENT",
 *       "operationStatus": "READY",
 *       "parentFolderId": "igje5u22nij3qkltzsnol37j3dnthvvh",
 *       "private": false,
 *       "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *       "sizeInBytes": "187199",
 *       "state": "OK",
 *       "thumbnailUrl": "https://static.wixstatic.com/media/it7ucst133nc8d9e0ff4d0nay1ucksc6.png",
 *       "url": "https://3ecba886-4267-11ee-be56-0242ac120002.usrfiles.com/ugd/w8ide0_f4dRFF610cKd7zkjVbaNddXgb181lXfg.pdf"
 *     },
 *     {
 *       "_createdDate": "2023-07-16T08:56:07.000Z",
 *       "_id": "w8ide0_170y03n3akmstnpt5jmsju89wvgs9tg4.pdf",
 *       "_updatedDate": "2023-07-16T08:56:07.000Z",
 *       "displayName": "file2.pdf",
 *       "hash": "g6x41coggaystn596ndb09q1ecg036gk",
 *       "internalTags": [
 *         "_fileOrigin_uploaded"
 *       ],
 *       "labels": [],
 *       "media": {
 *         "document": "wix:document://v1/w8ide0_170y03n3akmstnpt5jmsju89wvgs9tg4.pdf/file2.pdf"
 *       },
 *       "mediaType": "DOCUMENT",
 *       "operationStatus": "READY",
 *       "parentFolderId": "igje5u22nij3qkltzsnol37j3dnthvvh",
 *       "private": false,
 *       "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *       "sizeInBytes": "81624",
 *       "state": "OK",
 *       "thumbnailUrl": "https://static.wixstatic.com/media/it7ucst133nc8d9e0ff4d0nay1ucksc6.png",
 *       "url": "https://3ecba886-4267-11ee-be56-0242ac120002.usrfiles.com/ugd/w8ide0_170y03n3akmstnpt5jmsju89wvgs9tg4.pdf"
 *     }
 *   ],
 *   "nextCursor": {
 *     "cursors": {
 *       "next": ""
 *     },
 *     "hasNext": false
 *   }
 * }
 */
```

### List files in a specific folder (backend page code) (with elevated permissions)
```javascript
import { files } from '@wix/media';
import { auth } from '@wix/essentials';

/* Sample listOptions value:
 * {
 *   parentFolderId : 'igje5u22nij3qkltzsnol37j3dnthvvh'
 * }
 */

async function myListFilesFunction(listOptions) {
  try {
    const elevatedListFiles = auth.elevate(files.listFiles);
    const fileList = await elevatedListFiles(listOptions);

    console.log('Files in folder:', fileList);
    return fileList;
  } catch (error) {
    console.error(error);
    // Handle the error
  }
}

/* Promise resolves to:
 * {
 *   "files": [
 *     {
 *       "_createdDate": "2023-07-16T08:56:07.000Z",
 *       "_id": "w8ide0_f4dRFF610cKd7zkjVbaNddXgb181lXfg.pdf",
 *       "_updatedDate": "2023-07-16T08:56:07.000Z",
 *       "displayName": "file1.pdf",
 *       "hash": "z3bxokp79p04ok6iiu9ao8srx5lrynfh",
 *       "internalTags": [
 *         "_fileOrigin_uploaded"
 *       ],
 *       "labels": [],
 *       "media": {
 *         "document": "wix:document://v1/w8ide0_f4dRFF610cKd7zkjVbaNddXgb181lXfg.pdf/file1.pdf"
 *       },
 *       "mediaType": "DOCUMENT",
 *       "operationStatus": "READY",
 *       "parentFolderId": "igje5u22nij3qkltzsnol37j3dnthvvh",
 *       "private": false,
 *       "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *       "sizeInBytes": "187199",
 *       "state": "OK",
 *       "thumbnailUrl": "https://static.wixstatic.com/media/it7ucst133nc8d9e0ff4d0nay1ucksc6.png",
 *       "url": "https://3ecba886-4267-11ee-be56-0242ac120002.usrfiles.com/ugd/w8ide0_f4dRFF610cKd7zkjVbaNddXgb181lXfg.pdf"
 *     },
 *     {
 *       "_createdDate": "2023-07-16T08:56:07.000Z",
 *       "_id": "w8ide0_170y03n3akmstnpt5jmsju89wvgs9tg4.pdf",
 *       "_updatedDate": "2023-07-16T08:56:07.000Z",
 *       "displayName": "file2.pdf",
 *       "hash": "g6x41coggaystn596ndb09q1ecg036gk",
 *       "internalTags": [
 *         "_fileOrigin_uploaded"
 *       ],
 *       "labels": [],
 *       "media": {
 *         "document": "wix:document://v1/w8ide0_170y03n3akmstnpt5jmsju89wvgs9tg4.pdf/file2.pdf"
 *       },
 *       "mediaType": "DOCUMENT",
 *       "operationStatus": "READY",
 *       "parentFolderId": "igje5u22nij3qkltzsnol37j3dnthvvh",
 *       "private": false,
 *       "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *       "sizeInBytes": "81624",
 *       "state": "OK",
 *       "thumbnailUrl": "https://static.wixstatic.com/media/it7ucst133nc8d9e0ff4d0nay1ucksc6.png",
 *       "url": "https://3ecba886-4267-11ee-be56-0242ac120002.usrfiles.com/ugd/w8ide0_170y03n3akmstnpt5jmsju89wvgs9tg4.pdf"
 *     }
 *   ],
 *   "nextCursor": {
 *     "cursors": {
 *       "next": ""
 *     },
 *     "hasNext": false
 *   }
 * }
 */
```

### List files in a specific folder (backend page code)
```javascript
import { files } from '@wix/media';

/* Sample listOptions value:
 * {
 *   parentFolderId : 'igje5u22nij3qkltzsnol37j3dnthvvh'
 * }
 */

async function myListFilesFunction(listOptions) {
  try {
    const fileList = await files.listFiles(listOptions);

    console.log('Files in folder:', fileList);
    return fileList;
  } catch (error) {
    console.error(error);
    // Handle the error
  }
}

/* Promise resolves to:
 * {
 *   "files": [
 *     {
 *       "_createdDate": "2023-07-16T08:56:07.000Z",
 *       "_id": "w8ide0_f4dRFF610cKd7zkjVbaNddXgb181lXfg.pdf",
 *       "_updatedDate": "2023-07-16T08:56:07.000Z",
 *       "displayName": "file1.pdf",
 *       "hash": "z3bxokp79p04ok6iiu9ao8srx5lrynfh",
 *       "internalTags": [
 *         "_fileOrigin_uploaded"
 *       ],
 *       "labels": [],
 *       "media": {
 *         "document": "wix:document://v1/w8ide0_f4dRFF610cKd7zkjVbaNddXgb181lXfg.pdf/file1.pdf"
 *       },
 *       "mediaType": "DOCUMENT",
 *       "operationStatus": "READY",
 *       "parentFolderId": "igje5u22nij3qkltzsnol37j3dnthvvh",
 *       "private": false,
 *       "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *       "sizeInBytes": "187199",
 *       "state": "OK",
 *       "thumbnailUrl": "https://static.wixstatic.com/media/it7ucst133nc8d9e0ff4d0nay1ucksc6.png",
 *       "url": "https://3ecba886-4267-11ee-be56-0242ac120002.usrfiles.com/ugd/w8ide0_f4dRFF610cKd7zkjVbaNddXgb181lXfg.pdf"
 *     },
 *     {
 *       "_createdDate": "2023-07-16T08:56:07.000Z",
 *       "_id": "w8ide0_170y03n3akmstnpt5jmsju89wvgs9tg4.pdf",
 *       "_updatedDate": "2023-07-16T08:56:07.000Z",
 *       "displayName": "file2.pdf",
 *       "hash": "g6x41coggaystn596ndb09q1ecg036gk",
 *       "internalTags": [
 *         "_fileOrigin_uploaded"
 *       ],
 *       "labels": [],
 *       "media": {
 *         "document": "wix:document://v1/w8ide0_170y03n3akmstnpt5jmsju89wvgs9tg4.pdf/file2.pdf"
 *       },
 *       "mediaType": "DOCUMENT",
 *       "operationStatus": "READY",
 *       "parentFolderId": "igje5u22nij3qkltzsnol37j3dnthvvh",
 *       "private": false,
 *       "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *       "sizeInBytes": "81624",
 *       "state": "OK",
 *       "thumbnailUrl": "https://static.wixstatic.com/media/it7ucst133nc8d9e0ff4d0nay1ucksc6.png",
 *       "url": "https://3ecba886-4267-11ee-be56-0242ac120002.usrfiles.com/ugd/w8ide0_170y03n3akmstnpt5jmsju89wvgs9tg4.pdf"
 *     }
 *   ],
 *   "nextCursor": {
 *     "cursors": {
 *       "next": ""
 *     },
 *     "hasNext": false
 *   }
 * }
 */
```

### listFiles (self-hosted)
Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { files } from '@wix/media';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { files },
  // Include the auth strategy and host as relevant
});


async function listFiles(options) {
  const response = await myWixClient.files.listFiles(options);
};
```

---