---
title: "Get a streaming download link for a file of any size (up to 2 GB)"
method: POST
path: "/sandboxes/{id}/files/download-url"
tags: ["sandboxes"]
---

# Get a streaming download link for a file of any size (up to 2 GB)

`POST /sandboxes/{id}/files/download-url`

## Request

- Base URL: `https://api.eqvps.com/api/v1/eqvps`
- URL: `https://api.eqvps.com/api/v1/eqvps/sandboxes/{id}/files/download-url`
- Auth: HTTP bearer

For build artifacts and big files: returns a short-lived HTTPS link (GET) that streams ONE file of this sandbox — not base64, nothing passes through the model context. The link works only until expires_at and only while the sandbox runs. MCP: get_download_url.

## Path parameters

- `id` string, required

## Request body

- object
  - `path` string, required: Absolute path inside the sandbox
  - `ttl` integer: Link lifetime, seconds

## Response `200`

One-time link to one file of THIS sandbox

- object
  - `url` string, uri
  - `method` string
  - `path` string
  - `expires_at` string, date-time
  - `example` string
  - `note` string

## Other responses

- `404`: not_found
- `409`: sandbox_paused / sandbox_not_running

---

[API](https://skmtc.dev/eqvps/apis/eqvps-api.md) · [All operations](https://skmtc.dev/eqvps/apis/eqvps-api/llms.txt) · [OpenAPI document](https://skmtc.dev/eqvps/apis/eqvps-api/revisions/2cbc15a2b088?raw)
