POST

Query File Descriptors


Retrieves a list of files in the Media Manager, given the provided cursor paging, filtering, and sorting.

Query File Descriptors runs with these defaults, which you can override:

  • updatedDate is sorted in DESC order
  • cursorPaging.limit is 100

Up to 100 files can be returned per request.

Filterable fields: mediaType, private, and state. Sortable fields: displayName, updatedDate, and sizeInBytes.

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 and Sorting and Paging.

PropertyFiltersSort
displayNameSort: ASC, DESC
sizeInBytesSort: ASC, DESC
private$eqNone
mediaType$eq, $inNone
updatedDateSort: ASC, DESC
state$eqNone
Authentication

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

Permission Scopes
Read Media Manager
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/site-media/v1/files/query

Errors

This method doesn't return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?