---
url: /process-functions/web-download.md
description: Downloads a file to the MODLR Filesystem.
---

# web.download

Downloads a file to the MODLR Filesystem. This can be accessed via processes using the MODLR Filesystem or through the MODLR FTP Server.

```js
  web.download(url, filename)
```

The following 2 overloads are available as of 

```js
  web.download(url, filename, headers)
  web.download(url, filename, headers, method, body)
```

#### Parameters

* `url` (string): The URL of the file to download.
* `filename` (string): The filename to save the downloaded file as
* `headers` (object): An object containing custom headers to include in the request. The keys represent header names, and the values represent the corresponding header values. `(optional)`
* `method` (string): The HTTP method to use for the request (e.g. `GET`, `POST`, `PUT`, `PATCH`, `DELETE`). Defaults to `GET`. `(optional)`
* `body` (object|string): The request body data. It can be an object representing key-value pairs (to be serialized as JSON) or a string with the raw body data. `(optional)`

#### Returns

* `success` (boolean): Wether or not the download is successful.

#### Examples

```js
// Simple download
var success = web.download(
  "https://api.example.com/some_file.zip",
  "some_file.zip",
);

// Download with custom headers (e.g. authentication)
var success = web.download(
  "https://api.example.com/protected_file.zip",
  "protected_file.zip",
  { Authorization: "Bearer your_token" },
);

// Download the result of a POST request with a JSON body
var success = web.download(
  "https://api.example.com/export",
  "export.json",
  { "Content-Type": "application/json" },
  "POST",
  { reportId: 42, format: "json" },
);
```