POST

Get File Descriptors


Gets information about specific files in the Media Manager.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage Bookings Services and Settings
Manage Media Manager
Read Media Manager
Manage Portfolio
Manage Restaurants - all permissions
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/site-media/v1/files/get-files

Body Params
fileIdsArray <string>RequiredminItems 1maxItems 100maxLength 1000

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 (SDK | REST).

Response Object
filesArray <FileDescriptor>maxItems 100

Information about the requested files.

Get information about specific files
Request
cURL
curl -X POST \ 'https://www.wixapis.com/site-media/v1/files/get-files' \ -H 'Authorization: <AUTH>' -H 'Content-Type: application/json' \ --data-binary '{ "fileIds": ["4acbb8_7596aeebcf5c41eca01c0d99667ac967.mp3", "3vcbb7_7446aeebcf5c41eca01c0d99665bc866.mp3"] }'
Response
JSON
{ "files": [ { "id": "4acbb8_5646ee01a5524905af4f2e7c567cbbce", "displayName": "sample-mpg-file.mpg", "url": "https://video.wixstatic.com/video/4acbb8_5646ee01a5524905af4f2e7c567cbbce/file", "parentFolderId": "media-root", "hash": "6f9dad8f467c579269d96fdb4f7c95cd", "sizeInBytes": "5918720", "private": false, "mediaType": "VIDEO", "media": { "video": { "id": "4acbb8_5646ee01a5524905af4f2e7c567cbbce", "resolutions": [ { "url": "https://video.wixstatic.com/video/4acbb8_5646ee01a5524905af4f2e7c567cbbce/240p/mp4/file.mp4", "height": 240, "width": 320, "poster": null, "format": "mp4", "urlExpirationDate": null, "sizeInBytes": null, "quality": "240p", "filename": null }, { "url": "https://video.wixstatic.com/video/4acbb8_5646ee01a5524905af4f2e7c567cbbce/storyboard/144p/mp4/file.mp4", "height": 144, "width": 192, "poster": null, "format": "mp4", "urlExpirationDate": null, "sizeInBytes": null, "quality": "144p", "filename": null } ], "filename": "sample-mpg-file.mpg", "url": "https://video.wixstatic.com/video/4acbb8_5646ee01a5524905af4f2e7c567cbbce/file", "posters": [ { "id": "", "url": "https://static.wixstatic.com/media/4acbb8_5646ee01a5524905af4f2e7c567cbbcef000.jpg", "height": 240, "width": 320, "altText": null, "urlExpirationDate": null, "filename": null, "sizeInBytes": null }, { "id": "", "url": "https://static.wixstatic.com/media/4acbb8_5646ee01a5524905af4f2e7c567cbbcef001.jpg", "height": 240, "width": 320, "altText": null, "urlExpirationDate": null, "filename": null, "sizeInBytes": null }, { "id": "", "url": "https://static.wixstatic.com/media/4acbb8_5646ee01a5524905af4f2e7c567cbbcef003.jpg", "height": 240, "width": 320, "altText": null, "urlExpirationDate": null, "filename": null, "sizeInBytes": null } ], "sizeInBytes": "5918720", "urlExpirationDate": null } }, "operationStatus": "READY", "sourceUrl": null, "thumbnailUrl": "https://static.wixstatic.com/media/4acbb8_5646ee01a5524905af4f2e7c567cbbcef002.jpg", "labels": [], "createdDate": "2022-08-21T15:39:09Z", "updatedDate": "2022-08-21T15:39:21Z", "state": "OK" }, { "id": "3vcbb7_7446aeebcf5c41eca01c0d99665bc866", "displayName": "sample-mpg-file.mpg", "url": "https://video.wixstatic.com/video/3vcbb7_7446aeebcf5c41eca01c0d99665bc866/file", "parentFolderId": "media-root", "hash": "6f9dad8f467c579269d96fdb4f7c95cd", "sizeInBytes": "5918720", "private": false, "mediaType": "VIDEO", "media": { "video": { "id": "3vcbb7_7446aeebcf5c41eca01c0d99665bc866", "resolutions": [ { "url": "https://video.wixstatic.com/video/3vcbb7_7446aeebcf5c41eca01c0d99665bc866/240p/mp4/file.mp4", "height": 240, "width": 320, "poster": null, "format": "mp4", "urlExpirationDate": null, "sizeInBytes": null, "quality": "240p", "filename": null }, { "url": "https://video.wixstatic.com/video/3vcbb7_7446aeebcf5c41eca01c0d99665bc866/storyboard/144p/mp4/file.mp4", "height": 144, "width": 192, "poster": null, "format": "mp4", "urlExpirationDate": null, "sizeInBytes": null, "quality": "144p", "filename": null } ], "filename": "sample-mpg-file.mpg", "url": "https://video.wixstatic.com/video/3vcbb7_7446aeebcf5c41eca01c0d99665bc866/file", "posters": [ { "id": "", "url": "https://static.wixstatic.com/media/3vcbb7_7446aeebcf5c41eca01c0d99665bc866.jpg", "height": 240, "width": 320, "altText": null, "urlExpirationDate": null, "filename": null, "sizeInBytes": null }, { "id": "", "url": "https://static.wixstatic.com/media/3vcbb7_7446aeebcf5c41eca01c0d99665bc866.jpg", "height": 240, "width": 320, "altText": null, "urlExpirationDate": null, "filename": null, "sizeInBytes": null }, { "id": "", "url": "https://static.wixstatic.com/media/4acbb8_5646ee01a5524905af4f2e7c567cbbcef003.jpg", "height": 240, "width": 320, "altText": null, "urlExpirationDate": null, "filename": null, "sizeInBytes": null } ], "sizeInBytes": "5918720", "urlExpirationDate": null } }, "operationStatus": "READY", "sourceUrl": null, "thumbnailUrl": "https://static.wixstatic.com/media/3vcbb7_7446aeebcf5c41eca01c0d99665bc866.jpg", "labels": [], "createdDate": "2022-08-21T15:39:09Z", "updatedDate": "2022-08-21T15:39:21Z", "state": "OK" } ] }
Errors
400Invalid Argument

There is 1 error with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Did this help?