---
title: "tool si.files.download"
description: "a file's pointer from a task or a document, and where in the workspace to put it: progress by bytes moved of bytes in all, then the path inside the workspace."
section: reference
address: /reference/tools/si-files-download
contract: 0476e35e6e275db5
---

# tool si.files.download

a file's pointer from a task or a document, and where in the workspace to put it: progress by bytes moved of bytes in all, then the path inside the workspace.

[figure: Over MCP, si.files.download takes DownloadInput and returns a card whose body is FileTransfer.]

progress by bytes moved of bytes in all, then the path inside the workspace. The call needs the files grant at the user rung.



| | |
|---|---|
| input | [DownloadInput](/concepts/downloadinput) |
| result | a card whose body is [FileTransfer](/concepts/filetransfer) |
| read-only | no |
| destructive | no |
| card address | `ui://scale-intelligence/cards/FileTransfer` |
| HTTP route | [`/v1/files/download`](/reference/files/download) |





| field | type | required | note |
|---|---|---|---|
| `pointer` | `id` | yes |  |
| `into` | `text` | no |  |