# Folders

Source: https://docs.elnora.ai/docs/cli/folders
Last modified: 2026-09-08T22:34:42-06:00

> Create and manage folders.

Create and manage folders.

## elnora folders children

List the child folders of a Knowledge Base folder

*Read-only*

```bash
elnora folders children [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `folderId` | uuid | yes | Folder ID |

## elnora folders create

Create a Knowledge Base folder. (The legacy project-scoped path via `project` is deprecated and no longer supported.)

```bash
elnora folders create [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | yes | Folder name |
| `parentId` | uuid | no | Parent folder ID (for nesting) |
| `project` | uuid | no | [DEPRECATED] Legacy project-scoped folders were removed; this option is a no-op. |

## elnora folders delete

Delete a folder (Knowledge Base folders are archived)

*Destructive*

```bash
elnora folders delete [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `folderId` | uuid | yes | Folder ID to delete |
| `legacy` | boolean | no | Hard-delete a legacy project folder instead of archiving a Knowledge Base folder Default: `false`. |

## elnora folders files

List files placed directly in a Knowledge Base folder

*Read-only*

```bash
elnora folders files [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `folderId` | uuid | yes | Folder ID |
| `page` | integer | no | Page number Default: `1`. |
| `pageSize` | integer | no | Results per page Default: `25`. |

## elnora folders get

Get a Knowledge Base folder's details and breadcrumb path

*Read-only*

```bash
elnora folders get [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `folderId` | uuid | yes | Folder ID |

## elnora folders list

[DEPRECATED] List folders in a project — projects were removed. Use `folders roots` and `folders children` to browse the Knowledge Base.

*Read-only*

```bash
elnora folders list [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `projectId` | uuid | yes | Project ID |

## elnora folders move

Move a folder to a new parent (or to root)

```bash
elnora folders move [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `folderId` | uuid | yes | Folder ID to move |
| `legacy` | boolean | no | Move a legacy project folder instead of a Knowledge Base folder Default: `false`. |
| `parentId` | string | yes | Target parent folder ID, or 'root' to move to the top level |

## elnora folders rename

Rename a folder

*Idempotent*

```bash
elnora folders rename [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `folderId` | uuid | yes | Folder ID |
| `legacy` | boolean | no | Rename a legacy project folder instead of a Knowledge Base folder Default: `false`. |
| `name` | string | yes | New folder name |

## elnora folders roots

List the top-level Knowledge Base folders you can access

*Read-only*

```bash
elnora folders roots
```

## elnora folders share

Share a folder with a user or the whole organization (default role: editor)

```bash
elnora folders share [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `folderId` | uuid | yes | Folder ID to share |
| `orgWide` | boolean | no | Share with everyone in the organization Default: `false`. |
| `role` | enum | no | Access role to grant One of: `viewer`, `editor`, `admin`. Default: `editor`. |
| `userId` | integer | no | User ID to share with (omit when using --org-wide) |

## elnora folders shares

List the current shares on a folder

*Read-only*

```bash
elnora folders shares [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `folderId` | uuid | yes | Folder ID |

## elnora folders unshare

Revoke a folder share by its ACE id

*Destructive · Idempotent*

```bash
elnora folders unshare [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `aceId` | uuid | yes | Share (ACE) ID to revoke |
| `folderId` | uuid | yes | Folder ID |