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

# List Folders

> List folders and their full paths with dreep.listFolders().

```ts theme={null}
const { folders } = await dreep.listFolders();
```

With no filter this returns every folder in the project at any depth, each carrying its
full `path` — enough to build the entire tree from one call.

## Parameters

| Parameter  | Type          | Description                           |
| :--------- | :------------ | :------------------------------------ |
| `path`     | `string`      | List the children of this folder path |
| `parentId` | `string`      | List the children of this folder UUID |
| `signal`   | `AbortSignal` | Cancels the request                   |

## Returns

```ts theme={null}
{
  folders: [
    {
      id: "78b52933-…",
      name: "q1",
      slug: "q1",
      path: "2026/q1",
      parentId: "3ba2c6aa-…",
      accessControlType: "public",
    },
  ],
  currentFolder: { /* the folder named by path/parentId, or null */ },
}
```

## Listing one level

```ts theme={null}
const { folders, currentFolder } = await dreep.listFolders({ path: "avatars/2024" });
```

`currentFolder` is the folder the filter named, so one call gives you both a folder and
its children. An unknown path returns an empty list rather than throwing.