Return details about objects (bots, folders, and files) in a specific parent folder. This endpoint returns the object id, which is a numeric value that is used in other APIs to identify the file, folder or bot.

1. Add the authentication token to the request header.
2. Use the POST method and endpoint URL: <control_room_url>/v2/repository/folders/{folderId}/list
   {folderId} is the object ID of the folder that in which you want to search.
   Request body: The following example request searches for folders that contain the word finance in the name.

   {
     "filter": {
       "operator": "and",
       "operands": [
         {
           "operator": "substring",
           "field": "name",
           "value": "finance"
         },
         {
           "operator": "eq",
           "field": "folder",
           "value": "true"
         }
       ]
     }
   }

   Supported filterable fields

3. Send the request.
   Response body: In a successful request, this endpoint returns the following data:

   • id: a unique numeric identifier for the object that matches the search parameters.
   • parentId: a unique numeric identifier for the parent folder.
   • folder: a boolean value that returns true if the object is a folder and false if it is a bot or other file.
   In this example response, the endpoint returns a folder with the object id of 40378.

   {
     "page": {
       "offset": 0,
       "total": 329,
       "totalFilter": 1
     },
     "list": [
       {
         "id": "40378",
         "parentId": "2",
         "name": "EOD-finance-reports",
         "path": "Automation Anywhere\\Bots\\APAC\\EOD-finance-reports",
         "description": "",
         "type": "application/vnd.aa.directory",
         "size": "0",
         "folder": true,
         "folderCount": "0",
         "productionVersion": "",
         "latestVersion": "",
         "locked": false,
         "lockedBy": "0",
         "createdBy": "2587",
         "lastModifiedBy": "2587",
         "lastModified": "2020-09-02T05:26:51.162916Z",
         "permission": {
             "delete": true,
             "download": false,
             "upload": false,
             "run": true,
             "publishBotstore": false,
             "viewContent": true,
             "clone": false,
             "editContent": true,
             "createFolder": true,
             "move": true,
             "cancelCheckout": false,
             "revertCheckout": false
       },
         "workspaceId": "0",
         "botStatus": "DRAFT",
         "hasErrors": false,
         "workspaceType": "UNKNOWN",
         "metadata": false,
         "uri": "",
         "version": "0",
         "hasTriggers": false
       }
     ]
   }