---
title: "list"
description: 'Lists folders and files, folders first: under `folderId` (`null` for the root) or across the organization without it; active ones or, with `state: "trash"`, recoverable trash and then, with no `folderId` or `query`, trashed tables after the files; with `query`, only names containing it.'
---

| Tool | Kind | Purpose |
| :-- | :-- | :-- |
| `list` | read | Lists folders and files, folders first: under `folderId` (`null` for the root) or across the organization without it; active ones or, with `state: "trash"`, recoverable trash and then, with no `folderId` or `query`, trashed tables after the files; with `query`, only names containing it. `cursor` brings the next page. `fields` returns only those keys of each file and folder, plus `id`. |