# Files

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

> Upload, manage, and organize workspace files.

Upload, manage, and organize workspace files.

## elnora files archive

Archive (delete) a file

*Destructive*

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File ID to archive |

## elnora files commit

Commit a file's working copy

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File ID to commit |

## elnora files confirmUpload

Confirm a file upload

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File ID to confirm upload |

## elnora files content

Get the raw content of a file

*Read-only*

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File ID |

## elnora files create

Create a new file

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `folder` | uuid | no | Folder ID |
| `name` | string | yes | File name |
| `project` | uuid | no | Project ID (optional; defaults to your workspace) |
| `type` | string | yes | File type |

## elnora files createVersion

Create a new version of a file

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `content` | string | no | Version content |
| `fileId` | uuid | yes | File ID |

## elnora files download

Download a file

*Read-only*

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File ID to download |

## elnora files fork

Fork a file to another project

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File ID to fork |
| `targetProject` | uuid | no | Target project ID (optional; defaults to your workspace) |

## elnora files get

Get details of a specific file

*Read-only*

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File ID |

## elnora files list

List files in your workspace. (The legacy `project` filter is deprecated and no longer supported.)

*Read-only*

```bash
elnora files list [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | no | Page number Default: `1`. |
| `pageSize` | integer | no | Results per page Default: `25`. |
| `project` | uuid | no | [DEPRECATED] Legacy project filter; projects were removed and this option is a no-op. |

## elnora files move

Move a file to a different Knowledge Base folder

*Idempotent*

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File ID to move |
| `parentFolderId` | uuid | yes | Destination Knowledge Base folder ID |

## elnora files promote

Promote a file to a new visibility level

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File ID |
| `visibility` | string | yes | Visibility level |

## elnora files restore

Restore a file to a specific version

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File ID |
| `versionId` | uuid | yes | Version ID to restore |

## elnora files searchContent

Search file content across projects

*Read-only*

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | no | Page number Default: `1`. |
| `pageSize` | integer | no | Results per page Default: `25`. |
| `project` | uuid | no | Project ID to scope search |
| `query` | string | yes | Search query |

## elnora files share

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

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File 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 files shares

List the current shares on a file

*Read-only*

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File ID |

## elnora files unshare

Revoke a file share by its ACE id

*Destructive · Idempotent*

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

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

## elnora files update

Update a file's metadata

*Idempotent*

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File ID |
| `folder` | uuid | no | New folder ID |
| `name` | string | no | New file name |

## elnora files upload

Upload a file to a project (three-stage: presign, PUT, confirm)

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `contentType` | string | no | MIME content type |
| `fileName` | string | no | Override file name |
| `filePath` | string | yes | Local file path to upload |
| `project` | uuid | no | Project ID (optional; defaults to your workspace) |

## elnora files uploadBatch

Upload multiple files to a project (max 50)

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `filePaths` | string | yes | Comma-separated local file paths to upload |
| `folder` | uuid | no | Folder ID |
| `project` | uuid | no | Project ID (optional; defaults to your workspace) |

## elnora files versionContent

Get the raw content of a specific file version

*Read-only*

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File ID |
| `versionId` | uuid | yes | Version ID |

## elnora files versions

List versions of a file

*Read-only*

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

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

## elnora files workingCopy

Create a working copy of a file

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

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileId` | uuid | yes | File ID |
| `task` | uuid | no | Task ID |