# MailFolderList

### Summary

* Lists mail folders to support filing, move operations, and navigation.

### Graph Endpoint

* Top level: `GET /me/mailFolders`
* Children: `GET /me/mailFolders/{parentId}/childFolders`

### Parameters

#### Optional

* `parentId: string` — If provided, lists child folders of the given folder.
* `top: number` — 1..100

### Usage (app.businessFunction)

#### Top-level folders

```js
app.businessFunction({
  functionName: 'MicrosoftGraph',
  methodName: 'Mail',
  operation: 'FolderList',
  parameters: {
    top: 50
  }
})
```

#### Child folders of a parent

```js
app.businessFunction({
  functionName: 'MicrosoftGraph',
  methodName: 'Mail',
  operation: 'FolderList',
  parameters: {
    parentId: 'AAMkAGI2N...'
  }
})
```

### Response

```json
{
  "items": [
    {
      "id": "AQMkAGI2N...",
      "displayName": "Archive",
      "childFolderCount": 3,
      "unreadItemCount": 12,
      "totalItemCount": 120
    }
  ],
  "nextLink": "..."
}
```
