> 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

# QueryFileDescriptors

# Package: mediaManager

# Namespace: FilesService

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

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

## Introduction

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.md#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/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language.md) and
[Sorting and Paging](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-sorting-and-paging.md).

---

## REST API

### Schema

```
 Method: queryFileDescriptors
 Description: 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.md#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/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language.md) and [Sorting and Paging](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-sorting-and-paging.md).
 URL: https://www.wixapis.com/site-media/v1/files/query
 Method: POST
 Method parameters:
   param name: query | type: CursorQuery   
     - name: cursorPaging | type: CursorPaging | description: Cursor paging options.  Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language.md#cursor-paging). 
        - 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. 
        - name: filter | type: object | description: Filter object.  Learn more about [filtering](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language.md#filters). 
        - name: sort | type: array<Sorting> | description: Sort object.  Learn more about [sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language.md#sorting). 
           - name: fieldName | type: string | description: Name of the field to sort by. 
           - name: order | type: SortOrder | description: Sort order. Use `ASC` for ascending order or `DESC` for descending order.  Default: `ASC` 
                 - enum: ASC, DESC
 Return type: QueryFileDescriptorsResponse
  - name: files | type: array<FileDescriptor> | description: Retrieved files that match the query. 
     - 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: pagingMetadata | type: PagingMetadataV2 | description: Paging metadata, including the cursors for the next and previous pages. 
     - 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. 


```

### Examples

### Query file Descriptors
```curl
curl -X POST \
  'https://www.wixapis.com/site-media/v1/files/query' \
  -H 'Authorization: <AUTH>'
  --data-binary '{
    "query": {
      "filter": {
        "mediaType": {
          "$in":["IMAGE","VIDEO"]
        },
        "state": "OK",
        "private": false
      },
      "sort": {
        "fieldName": "updatedDate",
        "order": "DESC"
      },
      "cursorPaging": {
        "cursor": "test_cursor",
        "limit": 10
      }
    }
  }'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.mediaManager.FilesService.queryFileDescriptors(query)
 Description: 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.md#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/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language.md) and [Sorting and Paging](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-sorting-and-paging.md).
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  query
 Method parameters: 
   param name: query | type: FileDescriptorQuery   | required: true
     - name: cursorPaging | type: CursorPaging | description: Cursor paging options.  Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language.md#cursor-paging). 
        - 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. 
        - name: filter | type: object | description: Filter object.  Learn more about [filtering](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language.md#filters). 
        - name: sort | type: array<Sorting> | description: Sort object.  Learn more about [sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language.md#sorting). 
           - name: fieldName | type: string | description: Name of the field to sort by. 
           - name: order | type: SortOrder | description: Sort order. Use `ASC` for ascending order or `DESC` for descending order.  Default: `ASC` 
                 - enum: ASC, DESC
 Return type: PROMISE<QueryFileDescriptorsResponse>
  - name: files | type: array<FileDescriptor> | description: Retrieved files that match the query. 
     - 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: pagingMetadata | type: PagingMetadataV2 | description: Paging metadata, including the cursors for the next and previous pages. 
     - 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. 


```

### Examples

### Query file descriptors with cursor paging
Paginate through query results using cursor-based paging.

```javascript
import { files } from '@wix/media';

async function myQueryAllFilesFunction() {
  const allFiles = [];
  let cursor = undefined;
  let hasNext = true;

  try {
    while (hasNext) {
      const result = await files.queryFileDescriptors({
        query: {
          filter: {
            state: 'OK',
          },
          cursorPaging: {
            limit: 50,
            cursor,
          },
        },
      });

      allFiles.push(...result.files);
      cursor = result.pagingMetadata?.cursors?.next;
      hasNext = result.pagingMetadata?.hasNext ?? false;
    }

    console.log(`Total files retrieved: ${allFiles.length}`);
    return allFiles;
  } catch (error) {
    console.error(error);
    // Handle the error
  }
}

/* Promise resolves to:
 * [
 *   {
 *     "_createdDate": "2023-07-16T08:54:05.000Z",
 *     "_id": "w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg",
 *     "_updatedDate": "2023-07-16T08:54:05.000Z",
 *     "displayName": "image2.jpg",
 *     "hash": "800fae3e0cb7908518a391c25864436c",
 *     "labels": [
 *       "label1",
 *       "label2"
 *     ],
 *     "mediaType": "IMAGE",
 *     "operationStatus": "READY",
 *     "parentFolderId": "media-root",
 *     "private": false,
 *     "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *     "sizeInBytes": "3013886",
 *     "state": "OK",
 *     "url": "https://static.wixstatic.com/media/w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg"
 *   },
 *   {
 *     "_createdDate": "2023-07-16T08:56:07.000Z",
 *     "_id": "w8ide0_suuti24j47vesffndm8hkd651u72vp3f~mv2.jpg",
 *     "_updatedDate": "2023-07-16T08:56:07.000Z",
 *     "displayName": "image1.jpg",
 *     "hash": "fef0ylitxcnlyzxf0nahu8rh3k0i5t85",
 *     "labels": [
 *       "label1"
 *     ],
 *     "mediaType": "IMAGE",
 *     "operationStatus": "READY",
 *     "parentFolderId": "media-root",
 *     "private": false,
 *     "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *     "sizeInBytes": "6312959",
 *     "state": "OK",
 *     "url": "https://static.wixstatic.com/media/w8ide0_suuti24j47vesffndm8hkd651u72vp3f~mv2.jpg"
 *   }
 * ]
 */

```

### Query file descriptors with filter and sort
Filter files by media type and sort by updated date in descending order.

```javascript
import { files } from '@wix/media';

async function myQueryFileDescriptorsFunction() {
  try {
    const result = await files.queryFileDescriptors({
      query: {
        filter: {
          mediaType: 'IMAGE',
          state: 'OK',
        },
        sort: {
          fieldName: 'updatedDate',
          order: 'DESC',
        },
        cursorPaging: {
          limit: 10,
        },
      },
    });

    console.log('Queried files sorted by updatedDate:', result);
    return result;
  } catch (error) {
    console.error(error);
    // Handle the error
  }
}

/* Promise resolves to:
 * {
 *   "files": [
 *     {
 *       "_createdDate": "2023-07-19T08:43:58.000Z",
 *       "_id": "w8ide0_j18vyi43l4adwd81tpioxumkojv3dg78~mv2.jpg",
 *       "_updatedDate": "2023-07-19T08:43:58.000Z",
 *       "displayName": "river.jpg",
 *       "hash": "xa8k1btltmtn0nimi7a2diwdxd4aujku",
 *       "labels": [
 *         "mountain stream",
 *         "fresh water"
 *       ],
 *       "media": {
 *         "image": {
 *           "colors": {
 *             "prominent": {
 *               "rgb": {
 *                 "b": 41,
 *                 "g": 41,
 *                 "r": 24
 *               }
 *             }
 *           },
 *           "faces": [],
 *           "image": "wix:image://v1/w8ide0_j18vyi43l4adwd81tpioxumkojv3dg78~mv2.jpg/river.jpg#originWidth=5760&originHeight=3840"
 *         }
 *       },
 *       "mediaType": "IMAGE",
 *       "operationStatus": "READY",
 *       "parentFolderId": "media-root",
 *       "private": false,
 *       "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *       "sizeInBytes": "3677628",
 *       "state": "OK",
 *       "thumbnailUrl": "https://static.wixstatic.com/media/w8ide0_j18vyi43l4adwd81tpioxumkojv3dg78~mv2.jpg",
 *       "url": "https://static.wixstatic.com/media/w8ide0_j18vyi43l4adwd81tpioxumkojv3dg78~mv2.jpg"
 *     },
 *     {
 *       "_createdDate": "2023-07-16T08:54:05.000Z",
 *       "_id": "w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg",
 *       "_updatedDate": "2023-07-16T08:54:05.000Z",
 *       "displayName": "image2.jpg",
 *       "hash": "800fae3e0cb7908518a391c25864436c",
 *       "labels": [
 *         "label1",
 *         "label2"
 *       ],
 *       "media": {
 *         "image": {
 *           "colors": {
 *             "prominent": {
 *               "rgb": {
 *                 "b": 26,
 *                 "g": 36,
 *                 "r": 39
 *               }
 *             }
 *           },
 *           "faces": [],
 *           "image": "wix:image://v1/w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg/image2.jpg#originWidth=5833&originHeight=3894"
 *         }
 *       },
 *       "mediaType": "IMAGE",
 *       "operationStatus": "READY",
 *       "parentFolderId": "media-root",
 *       "private": false,
 *       "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *       "sizeInBytes": "3013886",
 *       "state": "OK",
 *       "thumbnailUrl": "https://static.wixstatic.com/media/w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg",
 *       "url": "https://static.wixstatic.com/media/w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg"
 *     }
 *   ],
 *   "pagingMetadata": {
 *     "cursors": {
 *       "next": ""
 *     },
 *     "hasNext": false
 *   }
 * }
 */

```

### Query file descriptors with filter
Filter files by media type using the query filter syntax.

```javascript
import { files } from '@wix/media';

async function myQueryFileDescriptorsFunction() {
  try {
    const result = await files.queryFileDescriptors({
      query: {
        filter: {
          mediaType: {
            $in: ['IMAGE', 'VIDEO'],
          },
          state: 'OK',
          private: false,
        },
      },
    });

    console.log('Queried files:', result);
    return result;
  } catch (error) {
    console.error(error);
    // Handle the error
  }
}

/* Promise resolves to:
 * {
 *   "files": [
 *     {
 *       "_createdDate": "2023-07-16T08:54:05.000Z",
 *       "_id": "w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg",
 *       "_updatedDate": "2023-07-16T08:54:05.000Z",
 *       "displayName": "image2.jpg",
 *       "hash": "800fae3e0cb7908518a391c25864436c",
 *       "labels": [
 *         "label1",
 *         "label2"
 *       ],
 *       "media": {
 *         "image": {
 *           "colors": {
 *             "prominent": {
 *               "rgb": {
 *                 "b": 26,
 *                 "g": 36,
 *                 "r": 39
 *               }
 *             }
 *           },
 *           "faces": [],
 *           "image": "wix:image://v1/w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg/image2.jpg#originWidth=5833&originHeight=3894"
 *         }
 *       },
 *       "mediaType": "IMAGE",
 *       "operationStatus": "READY",
 *       "parentFolderId": "media-root",
 *       "private": false,
 *       "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *       "sizeInBytes": "3013886",
 *       "state": "OK",
 *       "thumbnailUrl": "https://static.wixstatic.com/media/w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg",
 *       "url": "https://static.wixstatic.com/media/w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg"
 *     }
 *   ],
 *   "pagingMetadata": {
 *     "cursors": {
 *       "next": ""
 *     },
 *     "hasNext": false
 *   }
 * }
 */

```

### Query file descriptors (with elevated permissions)
```javascript
import { files } from '@wix/media';
import { auth } from '@wix/essentials';

const elevatedQueryFileDescriptors = auth.elevate(files.queryFileDescriptors);

async function myQueryFileDescriptorsFunction() {
  try {
    const result = await elevatedQueryFileDescriptors();

    console.log('Queried files:', result);
    return result;
  } catch (error) {
    console.error(error);
    // Handle the error
  }
}

/* Promise resolves to:
 * {
 *   "files": [
 *     {
 *       "_createdDate": "2023-07-16T08:54:05.000Z",
 *       "_id": "w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg",
 *       "_updatedDate": "2023-07-16T08:54:05.000Z",
 *       "displayName": "image2.jpg",
 *       "hash": "800fae3e0cb7908518a391c25864436c",
 *       "labels": [
 *         "label1",
 *         "label2"
 *       ],
 *       "media": {
 *         "image": {
 *           "colors": {
 *             "prominent": {
 *               "rgb": {
 *                 "b": 26,
 *                 "g": 36,
 *                 "r": 39
 *               }
 *             }
 *           },
 *           "faces": [],
 *           "image": "wix:image://v1/w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg/image2.jpg#originWidth=5833&originHeight=3894"
 *         }
 *       },
 *       "mediaType": "IMAGE",
 *       "operationStatus": "READY",
 *       "parentFolderId": "media-root",
 *       "private": false,
 *       "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *       "sizeInBytes": "3013886",
 *       "state": "OK",
 *       "thumbnailUrl": "https://static.wixstatic.com/media/w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg",
 *       "url": "https://static.wixstatic.com/media/w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg"
 *     }
 *   ],
 *   "pagingMetadata": {
 *     "cursors": {
 *       "next": ""
 *     },
 *     "hasNext": false
 *   }
 * }
 */

```

### Query file descriptors
```javascript
import { files } from '@wix/media';

async function myQueryFileDescriptorsFunction() {
  try {
    const result = await files.queryFileDescriptors();

    console.log('Queried files:', result);
    return result;
  } catch (error) {
    console.error(error);
    // Handle the error
  }
}

/* Promise resolves to:
 * {
 *   "files": [
 *     {
 *       "_createdDate": "2023-07-16T08:54:05.000Z",
 *       "_id": "w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg",
 *       "_updatedDate": "2023-07-16T08:54:05.000Z",
 *       "displayName": "image2.jpg",
 *       "hash": "800fae3e0cb7908518a391c25864436c",
 *       "labels": [
 *         "label1",
 *         "label2"
 *       ],
 *       "media": {
 *         "image": {
 *           "colors": {
 *             "prominent": {
 *               "rgb": {
 *                 "b": 26,
 *                 "g": 36,
 *                 "r": 39
 *               }
 *             }
 *           },
 *           "faces": [],
 *           "image": "wix:image://v1/w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg/image2.jpg#originWidth=5833&originHeight=3894"
 *         }
 *       },
 *       "mediaType": "IMAGE",
 *       "operationStatus": "READY",
 *       "parentFolderId": "media-root",
 *       "private": false,
 *       "siteId": "3ecba886-4267-11ee-be56-0242ac120002",
 *       "sizeInBytes": "3013886",
 *       "state": "OK",
 *       "thumbnailUrl": "https://static.wixstatic.com/media/w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg",
 *       "url": "https://static.wixstatic.com/media/w8ide0_ouulk5w0mdr9omjkwsfyn71g4mb1olcf~mv2.jpg"
 *     }
 *   ],
 *   "pagingMetadata": {
 *     "cursors": {
 *       "next": ""
 *     },
 *     "hasNext": false
 *   }
 * }
 */

```

### queryFileDescriptors (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 queryFileDescriptors(query) {
  const response = await myWixClient.files.queryFileDescriptors(query);
};
```

---