> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# folders_list

> List the folders this key can reach, sorted alphabetically. The listing is flat and each folder names its parent in parent_folder_id, so a hierarchy is reassembled from a full walk. Use it to find the folder_id that narrows a note listing or a webhook endpoint's deliveries.

<div className="tool-route"><span className="tool-row-method" data-method="GET">GET</span><code>{"https://public-api.granola.ai/v1/folders"}</code></div>

```python granola_folders_list.py theme={null}
from charter.packs import granola

result = await granola.folders_list.ainvoke({})
```

<Note>
  Pages by cursor: `cursor` is sent back as `cursor`.
</Note>

## Query parameters

<div className="reference-table">
  | Field      | Type      | Description                                                                                                                                   |
  | ---------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
  | `cursor`   | `string`  | The cursor to continue from                                                                                                                   |
  | `pageSize` | `integer` | Maximum number of folders to return per page. The server returns 10 when this is absent. <span className="field-constraints">≥ 1; ≤ 30</span> |
</div>