Skip to main content
Use aspect upload to copy local files into an existing Aspect project or directory:
The destination is always the last argument. It must identify a project or an existing folder, and your account must have permission to upload there.

​
Upload folders and multiple sources

Folder uploads include the source folder’s name and recreate its nested file paths. For example, ./Footage/Day 01/interview.mov becomes:
You do not need a recursive flag. Symbolic links encountered inside a folder are skipped. Empty directories are not created independently of files. The CLI creates the folders needed for the uploaded file tree inside the destination. The destination URL itself must already resolve; create a new destination project or folder in Aspect first.

​
Choose what happens when a name exists

--replace and --keep-both cannot be combined. The default skip behavior compares destination conflicts; it does not make a changed local file into an automatic update. Choose --replace when you intend to upload revised content.

​
Large uploads

The CLI streams file content and handles chunked uploading for you. To keep a job running after the terminal closes:
Use the returned transfer ID to check progress or wait for completion. See Background transfers.

​
Completion and interruptions

A foreground upload prints progress and a final count of uploaded, skipped, and failed files. Add --json for a result that a script can read:
The result includes uploaded, skipped, and a failed array containing each failed path and its error. A skipped file counts as a successful outcome; any file failure or interruption makes the command exit with a nonzero status. Ctrl-C cancels a foreground job. You can rerun the same upload to skip files that already completed and try the remaining files again. This is a new transfer, not a promise to resume every partial file at its previous byte offset. An upload completing means the source file has reached Aspect. Proxy generation and other media processing happen separately; a streaming proxy may not be available immediately.