veri volumes

The veri volumes group manages persistent named storage in your workspace. A training job reads a volume either as one file connected with datasets.from_volume (downloaded at job start) or, coming soon, as a whole-volume read-only mount at /mnt/<name> through the job-level volume field. Conceptual overview lives in the Volumes guide.

Commands

Command	Purpose
`create <name>`	Create a volume (idempotent).
`list`	List your volumes.
`get <name>`	Show one volume’s metadata.
`delete <name> [--yes]`	Delete a volume + queue its S3 prefix for cleanup.
`upload <vol> <path> [--to /remote]`	Upload one file. Auto-multipart for files > 5 GiB.
`upload-dir <vol> <dir> [--to /]`	Recursively upload a directory (up to 8 files concurrent).
`ls <vol> [path]`	List files inside the volume.
`rm <vol> <path>`	Delete one file.

Create a volume

veri volumes create my-corpus

Names must match ^[a-zA-Z0-9][a-zA-Z0-9_-]{0,127}$. Re-running with the same name returns the existing volume: no error.

Upload files

For a single file:

veri volumes upload my-corpus ./train.jsonl

The remote path defaults to /<filename>. Override with --to:

veri volumes upload my-corpus ./train.jsonl --to /data/2026-05/train.jsonl

Files larger than 5 GiB are uploaded with S3 multipart automatically. A progress bar shows transfer rate, ETA, and total transferred. For a directory:

veri volumes upload-dir my-corpus ./training-data --to /data

Up to 8 files transfer concurrently. The progress bar reports cumulative bytes across all files. A per-file failure aborts the batch. You can safely re-run: an upload to the same path replaces the file.

List + inspect

$ veri volumes list
┃ name       ┃ id               ┃ size      ┃ files ┃ updated_at           ┃
┃ my-corpus  ┃ fb542b363508484e ┃ 14.2 GiB  ┃ 1023  ┃ 2026-05-14T18:22:09Z ┃

$ veri volumes get my-corpus --format json
{
  "id": "fb542b363508484e",
  "name": "my-corpus",
  "size": "14.2 GiB",
  "files": 1023,
  "updated_at": "2026-05-14T18:22:09Z"
}

List files inside a volume:

veri volumes ls my-corpus            # all files
veri volumes ls my-corpus /data/2026 # filter by prefix

Delete

veri volumes delete my-corpus

Prompts for the volume name as confirmation and shows the file count + total bytes that will be deleted. Pass --yes to skip the prompt in scripts:

veri volumes delete my-corpus --yes

The DB row is dropped immediately; the S3 prefix is reaped by a background reconciler within ~60 seconds. There is no undo. Delete a single file inside a volume without removing the volume itself:

veri volumes rm my-corpus /data/old.jsonl

Pipe-friendly output

--quiet strips formatting and emits just the relevant id:

VOL_ID=$(veri volumes create my-corpus --quiet)
echo $VOL_ID    # fb542b363508484e

--format json|jsonl|csv swaps the table renderer for machine-readable output, and the progress bar on uploads is suppressed.

veri volumes list --format json > volumes.json

Common workflows

Migrate from a local directory

veri volumes create research-corpus
veri volumes upload-dir research-corpus ./local-corpus --to /
veri volumes ls research-corpus    # confirm the file tree mirrors local

Inspect failed uploads

If volumes upload-dir aborts mid-batch, files that completed are already on the volume. Re-running the same command uploads every file again; S3 PUT is idempotent on the same key, so nothing is duplicated.

veri volumes ls my-corpus                 # see what made it
veri volumes upload-dir my-corpus ./data  # re-run; overwrites the same keys

Next steps

Volumes overview

What volumes are and how they are billed.

REST API

/v1/volumes endpoints + multipart upload protocol.

Get started

Training

Deployments

Evaluations

Agents

CLI

Volumes

Webhooks

Secrets

Billing

Commands

Create a volume

Upload files

List + inspect

Delete

Pipe-friendly output

Common workflows

Migrate from a local directory

Inspect failed uploads

Next steps

Volumes overview

REST API

​Commands

​Create a volume

​Upload files

​List + inspect

​Delete

​Pipe-friendly output

​Common workflows

​Migrate from a local directory

​Inspect failed uploads

​Next steps

Volumes overview

REST API

Commands

Create a volume

Upload files

List + inspect

Delete

Pipe-friendly output

Common workflows

Migrate from a local directory

Inspect failed uploads

Next steps