DELETE
Permanently delete a file from the project.oumi-cli files delete [OPTIONS] FILE_ID
| Argument | Type | Required | Description |
|---|---|---|---|
FILE_ID | integer | ✓ | ID of the file (see oumi-cli files list). |
| Option | Type | Required | Description |
|---|---|---|---|
--project | text | Project that owns the file; falls back to OUMI_PROJECT_ID or the active profile. | |
--force | flag | Skip the confirmation prompt. Without a TTY or under --no-input, this (or --yes) is required; otherwise the command exits 2 without changing anything. | |
--yes | flag | Same as --force. |
DOWNLOAD
Download a file to local disk.oumi-cli files download [OPTIONS] FILE_ID
| Argument | Type | Required | Description |
|---|---|---|---|
FILE_ID | integer | ✓ | ID of the file (see oumi-cli files list). |
| Option | Type | Required | Description |
|---|---|---|---|
--project | text | Project that owns the file; falls back to OUMI_PROJECT_ID or the active profile. | |
--out | path | Destination file or directory. Defaults to ./file-<id>.<ext> in the current directory. | |
--expiration | integer range | Lifetime of the download’s presigned URL, in seconds (max 604800, 7 days). Default: 3600. |
GET
Show metadata for a single file.oumi-cli files get [OPTIONS] FILE_ID
| Argument | Type | Required | Description |
|---|---|---|---|
FILE_ID | integer | ✓ | ID of the file (see oumi-cli files list). |
| Option | Type | Required | Description |
|---|---|---|---|
--project | text | Project that owns the file; falls back to OUMI_PROJECT_ID or the active profile. |
LIST
List files in a project, optionally filtered by kind.oumi-cli files list [OPTIONS]
| Option | Type | Required | Description |
|---|---|---|---|
--project | text | Project to list files from; falls back to OUMI_PROJECT_ID or the active profile. | |
--limit | integer range | Maximum number of files to return (default 100). | |
--all | flag | Return all files, following pages until none are left (capped by --max-items). Cannot be combined with --limit. | |
--max-items | integer range | Cap on how many files --all returns (default 10000). | |
--kind | choice | Filter by file kind: STRUCTURED (tabular data) or UNSTRUCTURED (free-text documents). Omit to return files of every kind. |
UPDATE
Rename a file.oumi-cli files update [OPTIONS] FILE_ID
| Argument | Type | Required | Description |
|---|---|---|---|
FILE_ID | integer | ✓ | ID of the file (see oumi-cli files list). |
| Option | Type | Required | Description |
|---|---|---|---|
--project | text | Project that owns the file; falls back to OUMI_PROJECT_ID or the active profile. | |
--display-name | text | New display name for the file. |
UPLOAD
Upload a local file, waiting for the ingest to finish by default.oumi-cli files upload [OPTIONS] FILE
| Argument | Type | Required | Description |
|---|---|---|---|
FILE | path | ✓ | Path to the local file to upload (max 5 GB). |
| Option | Type | Required | Description |
|---|---|---|---|
--project | text | Project to upload the file into; falls back to OUMI_PROJECT_ID or the active profile. | |
--display-name | text | Display name for the file. Defaults to the local filename. | |
--kind | choice | STRUCTURED (tabular data) or UNSTRUCTURED (free-text documents). Defaults to UNSTRUCTURED. | |
--expiration | integer | Lifetime of the upload’s presigned URL, in seconds. Default: 3600. | |
--wait / --no-wait | flag | Wait for the file ingest to finish (default); --no-wait returns the operation ID immediately; follow with oumi-cli operations wait <id>. |