> 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 # GetFileDescriptors # Package: mediaManager # Namespace: FilesService # Method link: https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/get-file-descriptors.md ## Permission Scopes: Read Media Manager: SCOPE.DC-MEDIA.READ-MEDIAMANAGER ## Introduction Gets information about specific files in the Media Manager. --- ## REST API ### Schema ``` Method: getFileDescriptors Description: Gets information about specific files in the Media Manager. URL: https://www.wixapis.com/site-media/v1/files/get-files Method: POST # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present. Required parameters: fileIds Method parameters: param name: fileIds | type: array | description: File GUIDs. 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 GUID parameter](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-id.md). | required: true Return type: GetFileDescriptorsResponse - name: files | type: array | description: Information about the requested files. - 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 | description: Color palette of the image. - name: faces | type: array | 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 | 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