Download File

Type: download_file

Request a copy of the most recent file viewed in the browser.

Parameters

Name	Type	Required	Description
timeout	integer		The maximum amount of time the browser should wait for a file to download. Default: 5,000 (5s)

See universal parameters.

Files Supported

Currently this only works with the following file formats: .pdf, .jpg, .png, .gif, .bmp, .webp, .svg, .tiff, .tif, .img

Usage

Download a copy of a PDF open in the Browser

The following waits 20s for a file to download and then returns it.

"actions": [
    {
        "type": "download_file",
        "timeout": 20000
    }
]

And the service responds with the file being in the action output:

"actions": [
      {
        "id": "act_VHhrUbXjZSaYCPTqbBYD4acCzzeFGH",
        "type": "download_file",
        "query": "download_file?continue_on_fail=false&timeout=20000",
        "timestamp": "2025-05-30T15:02:06.6615306Z",
        "output": "https://storage.gaffa.dev/brq/downloads/5845df07-3749-424e-9c64-9602be19a857.pdf"
      }
    ]