> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notte.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# download

<Tip>
  Read [the Notte skill](https://notte.cc/skill.md) and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.
</Tip>

[Source: node-sdk/src/files.ts](https://github.com/nottelabs/notte/blob/main/node-sdk/src/files.ts)

Download a file to `<localDir>/<filename>` and return the local path. The
file is written atomically (temporary file + rename). Rejects with
`FileExistsError` when the destination exists unless `force` is set.

```typescript theme={null}
RemoteFileStorage.download(fileId: string, localDir?: string, options?: FileDownloadOptions): Promise<string>;
```

## Parameters

<ParamField body="fileId" type={"string"} required>
  ID of the file to download.
</ParamField>

<ParamField body="localDir" type={"string"}>
  Destination directory, created if needed. Defaults to the current directory.

  Default:

  ```typescript theme={null}
  '.'
  ```
</ParamField>

<ParamField body="options" type={"FileDownloadOptions"}>
  Set `force` to overwrite an existing destination; defaults to false.

  Default:

  ```typescript theme={null}
  {}
  ```
</ParamField>

## Returns

```typescript theme={null}
Promise<string>
```

The local file path after the download has been written successfully.

## Raises

* NotteAPIError if the storage API request fails.
* InvalidRequestError if storage has not been bound to a session.
* FileExistsError if the destination exists and `force` is false. Filesystem errors also propagate.

## Example

```typescript theme={null}
const path = await storage.download(fileId, './downloads', { force: true });
```

## Related types

* [FileDownloadOptions](/typescript-sdk-reference/types/filedownloadoptions)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.