GET

List Deleted Folders

Retrieves a list of folders in the Media Manager's trash bin.

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
Manage Portfolio
Manage Restaurants - all permissions
Learn more about app permissions.
Endpoint
GET
https://www.wixapis.com/site-media/v1/trash-bin/folders
Query Params
parentFolderIdstring

ID of the folder's parent folder.

sort.fieldNamestringmaxLength 512

Name of the field to sort by.

sort.orderstring

Sort order.

paging.limitintegerminimum 0maximum 100format int32

Maximum number of items to return in the results.

paging.cursorstring

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.

Response Object
foldersArray <Folder>maxItems 200

List of folders in the Media Manager's trash bin.

nextCursorNextCursor

The next cursor if it exists.

List folders in the Media Manager's trash bin

This example sorts by updatedDate in DESC order with a paging limit of 2.

Request
cURL
curl -X GET \
  'https://www.wixapis.com/site-media/v1/trash-bin/folders?sort.fieldName=updateDate&sort.order=DESC&paging.limit=2' \
  -H 'Authorization: <AUTH>'
Response
JSON
{
  "folders": [
    {
      "id": "d147e1ab3e8b4114ad93d13bb9e23540",
      "displayName": "New Folder",
      "parentFolderId": "trash-root",
      "createdDate": "2022-08-30T16:56:29Z",
      "updatedDate": "2022-08-30T16:56:29Z",
      "state": "OK"
    },
    {
      "id": "5bfba6861eed4f009c6abba0dc8b47db",
      "displayName": "New Folder 2",
      "parentFolderId": "trash-root",
      "createdDate": "2022-04-17T15:37:02Z",
      "updatedDate": "2022-04-26T20:09:32Z",
      "state": "OK"
    }
  ],
  "nextCursor": {
    "cursors": {
      "next": ""
    },
    "hasNext": false
  }
}
Errors

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

Did this help?