request_download
Generate a short-lived download link for a vault file so a human can save it. Handy for PDFs, images, or archives that a raw byte response cannot render.
Instructions
Get a short-lived link a person can use to save a vault file. Peer to
read_file, which returns the bytes to you — use this one when the file is
for the human, not for you.
Handy for anything read_file would waste context on or cannot render: a
PDF, a large image, an archive. Reading works with a read-only key.
The token lives in the URL's # fragment, so it never reaches an access
log. Treat the whole URL as a secret — whoever holds it can read that
one file until it expires. Never put it in a query string.
The link is bound to the file as it is now: if it is edited or replaced, the link stops working rather than serving different content than you described. Unlike an upload link it can be used more than once, so the person can preview and then save.
From a shell: `curl -H "Authorization: Bearer " -o
Args:
path: Vault-relative path of the file to share.
expires_in: Seconds until the link dies. Clamped to 60–3600; defaults
to TRANSFER_TOKEN_TTL_SECONDS (600).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| expires_in | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |