Fetch Tool
amount.fetchDownloads files or entire folders from a storage mount into a site folder in the background and returns a run UUID for tracking progress.
Instructions
Download a file, or the files in a folder (recursive=true keeps subfolders, up to 2000 files; else the files directly inside, up to 200), from a storage mount into a site folder, in the background; returns a run uuid for amount.status. The mount may be one of the person's own computers (amount.computers): "from my computer mypc, folder 2025/08 of sqlbackups, into backups" is mount="mypc", remote="sqlbackups/2025/08", to="backups", recursive=true. When a name is taken here, a newer file replaces an older one only if destructive tools are allowed for this call; otherwise it is kept, and every file not written is listed with its reason in amount.status. Never writes executable files; the destination must be a folder the manager can modify; files from a computer fill a site folder only up to its quota.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"mount": "<mount>",
"remote": "<remote>",
"to": "<to>"
},
"name": "amount.fetch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Site folder to download into, e.g. "assets/backup" | |
| site | No | The site the person named ("site.com"): refused if this installation does not serve it. | |
| mount | Yes | Mount uuid (preferred) or name | |
| remote | Yes | Remote file or folder, e.g. "Backups/db-2026-10-16.sql.gz" | |
| recursive | No | Include subfolders, recreating them under `to`. Default false. | |
| on_conflict | No | "skip" keeps a file already here; "newer" lets a newer file replace an older one (needs destructive permission). Default: newer when destructive tools are allowed, else skip. | |
| delete_remote | No | Delete the remote copy after a verified download (destructive). Default false. |