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

# FILE_DOWNLOAD_FAILED

> File couldn't be downloaded (422)

Pulse couldn't fetch the document at `file_url`.

| Status | Retryable | Title |
| - | - | - |
| `422` | No | File couldn't be downloaded |

## Common causes

* The link answered an error status, or needs a sign-in (`reason`: `sign_in_required`).
* The link is a viewer page, not the file (`reason`: `viewer_page`).
* The host couldn't be reached.
* A link into your Pulse storage names no file (`reason`: `not_found`).

## What to do

Send a direct, public or presigned link to the file itself.

## Example

```json theme={null}
{
  "type": "https://docs.runpulse.com/errors/file-download-failed",
  "title": "File couldn't be downloaded",
  "status": 422,
  "detail": "the file's server answered 403 Forbidden",
  "instance": "urn:pulse:request:req-6f1c2a9e-3b7d-4c55-9a8e-2d4f0b1c7e93",
  "code": "FILE_DOWNLOAD_FAILED",
  "request_id": "req-6f1c2a9e-3b7d-4c55-9a8e-2d4f0b1c7e93",
  "retryable": false
}
```

In API version 1 this was `FILE_005`.


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