Folders

A folder groups recordings in the workspace and can be nested. Move a recording into a folder with recordings update --folder-id. For fields and response details, see the API reference.

List folders

This command lists every folder in the workspace with the number of recordings in each.

neetorecord folders list --page-size 50 --sort-by name --sort-direction asc

recording_count counts only the uploaded recordings you can see.

Flag	Type	Default	Description
`--page`	`int`	`0`	Page number
`--page-size`	`int`	`0`	Items per page (max 100)
`--sort-by`	`string`		Sort by created_at or name
`--sort-direction`	`string`		Sort direction: asc or desc

Sample output (--json)

{
  "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
  }
}

Create a folder

This command creates a folder. Pass --parent-folder-id to nest it under an existing one.

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)

Sample output (--json)

{
  "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:

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

Getting started

Commands

List folders

Create a folder

​List folders

​Create a folder

List folders

Create a folder