Downloads

MASV Agent can download any MASV Package provided you have a valid download URL in the format https://get.massive.io/{ID}?secret={SECRET}. For password-protected downloads, you also need the password. MASV Agent rebuilds the directory structure of the Package as sent by the sender. Initiating and managing downloads does not require a user session.

Note

Special characters in file names for cross-platform downloads may result in modified file names. MASV Agent removes special characters to conform to the receiving platform’s file name requirements.

Downloads transition through these states:

State	Description
transferring	The download is currently transferring data.
paused	The download is paused by the user.
complete	The download has been completed.
error	A fatal error was encountered. This may be recoverable depending on the error type.

Download a Package

Supply the full download Link URL and a destination folder:

CLI

masv download start \
  --url 'https://get.massive.io/LINK_ID?secret=LINK_SECRET' \
  --destination /destination/folder \
  --password 'optional_password'

Name	Type	Required	Description
bypass-package-quarantine	Boolean	No	Ignore malware warnings and only download unaffected files (default true).
create-package-folder	Boolean	No	Download files inside a Package folder (default true).
destination	String	Yes	Path to the download destination directory.
file-ids	String	No	Comma-separated list of Package file IDs to include. Example: '01FDFQW6Y9...,01HZMN7V90...'
password	String	No	Download password that may be required by the Link.
priority	Integer	No	Download priority. Higher values mean higher priority.
url	String	Yes	The full download Link URL.
gid	Integer	No	GID override to assign file ownership.
uid	Integer	No	UID override to assign file ownership.

REST API

curl -X POST -H "Content-Type: application/json" \
  http://localhost:8080/api/v1/downloads -d '{
    "url": "https://get.massive.io/LINK_ID?secret=LINK_SECRET",
    "dst_folder": "/destination/folder",
    "password": "optional_password"
  }'

Name	Type	Required	Description
bypass_package_quarantine	Boolean	No	Ignore malware warnings and only download unaffected files (default true).
chunk_size	Integer	No	Target chunk size for the download.
create_package_folder	Boolean	No	Download files inside a Package folder (default true).
dst_folder	String	Yes	Path to the download destination directory.
file_ids	Array	No	Array of Package file IDs to include. Example: ["01FDFQW6Y9...", "01HZMN7V90..."]
password	String	No	Download password that may be required by the Link.
priority	Integer	No	Download priority. Higher values mean higher priority.
url	String	Yes	The full download Link URL.
group_id	Integer	No	GID override to assign file ownership.
user_id	Integer	No	UID override to assign file ownership.

If successful, MASV Agent responds with the new download ID:

{
  "download_id": "f98b1e92-1c67-48e4-9b9c-f2bb27a33375"
}

---

View download status

List all downloads managed by MASV Agent:

CLI

masv download ls

REST API

curl -X GET http://localhost:8080/api/v1/downloads

View full details for a specific download, including individual file states:

CLI

masv download status {DOWNLOAD_ID}

REST API

curl -X GET http://localhost:8080/api/v1/downloads/{DOWNLOAD_ID}

---

Manage downloads

Pause a download

CLI

masv download pause {DOWNLOAD_ID}

REST API

curl -X POST http://localhost:8080/api/v1/downloads/{DOWNLOAD_ID}/pause

Pause all downloads

CLI

masv download pause all

REST API

curl -X POST http://localhost:8080/api/v1/downloads/pause

Resume a download

CLI

masv download resume {DOWNLOAD_ID}

REST API

curl -X POST http://localhost:8080/api/v1/downloads/{DOWNLOAD_ID}/resume

Resume all downloads

CLI

masv download resume all

REST API

curl -X POST http://localhost:8080/api/v1/downloads/resume

Delete a download

CLI

masv download rm {DOWNLOAD_ID}

REST API

curl -X DELETE http://localhost:8080/api/v1/downloads/{DOWNLOAD_ID}

Caution

Deleting a download does not automatically delete the completed files from the file system.

Delete a download and its files

CLI

masv download rm {DOWNLOAD_ID} --remove-files

REST API

curl -X DELETE http://localhost:8080/api/v1/downloads/{DOWNLOAD_ID}?remove_files=true

Delete all downloads

CLI

masv download rm all

REST API

curl -X DELETE http://localhost:8080/api/v1/downloads

Delete downloads by state

CLI

masv download rm all --states=complete,error

REST API

curl -X DELETE http://localhost:8080/api/v1/downloads?states=complete,error

---

Next steps

• Uploads — Send files via Team email, shareable Link, or Portal.
• Automations — Set up automated download and upload workflows.
• Storage Gateway — Connect storage devices to MASV.