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

# folders

> List and create the folders that recordings are organized into.

Folders group recordings in the workspace and can be nested. Move a recording
into a folder with [`recordings update --folder-id`](/cli-reference/recordings#recordings-update).
For fields and response details, see the [API reference](/api-reference/folders/list).

<Info>
  Sample output on this page is the JSON envelope you get with `--json`. On a
  terminal the same data prints as a table or a key-value list. See
  [Output formats](/cli/output-formats).
</Info>

## folders list

Lists every folder in the workspace with the number of recordings in each.

```bash theme={"system"}
neetorecord folders list --page-size 50
```

| Flag          | Type  | Required | Default | Description              |
| ------------- | ----- | -------- | ------- | ------------------------ |
| `--page`      | `int` |          | `0`     | Page number              |
| `--page-size` | `int` |          | `0`     | Items per page (max 100) |

```json theme={"system"}
{
  "data": [
    {
      "id": "hqzptnv",
      "name": "Product demos",
      "parent_id": null,
      "recording_count": 12,
      "created_at": "2025-06-02T11:40:18.000Z"
    }
  ],
  "pagination": {
    "total_records": 8,
    "total_pages": 1,
    "current_page_number": 1,
    "page_size": 50
  }
}
```

## folders create

Creates a folder. Pass `--parent-folder-id` to nest it under an existing one.

```bash theme={"system"}
neetorecord folders create --name "Onboarding" --parent-folder-id hqzptnv
```

| Flag                 | Type     | Required | Default | Description                           |
| -------------------- | -------- | -------- | ------- | ------------------------------------- |
| `--name`             | `string` | Yes      |         | Folder name                           |
| `--parent-folder-id` | `string` |          |         | Parent folder ID (for nested folders) |

```json theme={"system"}
{
  "data": {
    "id": "wbrkxdm",
    "name": "Onboarding",
    "parent_id": "hqzptnv",
    "created_at": "2025-07-14T08:12:03.000Z"
  }
}
```

With `--quiet` the command prints just the new folder's id, which makes it easy
to chain:

```bash theme={"system"}
id=$(neetorecord folders create --name "Onboarding" --quiet)
neetorecord recordings update 3f6a1c58-9b2e-4d77-8a10-5c0b1e2f3a4d --folder-id "$id"
```