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 Events
Access Verticals by Automations
Set Up Automations
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?