---
title: "Changes to File Download Task"
method: POST
path: "/v1/run/tasks/download_files"
---

# Changes to File Download Task

`POST /v1/run/tasks/download_files`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 14 of 139 revisions.

- **2026-10-20** `539f04093540`: 1 warning, 1 info
- **2026-10-07** `ee3c528838cb`: 1 info
- **2026-09-25** `66f8cba9377d`: 1 info
- **2026-09-15** `272ef19d1017`: 4 info
- **2026-09-15** `f6a594c58678`: 1 info
- **2026-08-22** `89037b86e004`: 1 info
- **2026-08-19** `830020b643cd`: 1 info
- **2026-07-24** `bd64e0480f0a`: 3 info
- **2026-07-20** `b7fa64d35769`: 1 warning
- **2026-06-15** `cd89b4c6f004`: 1 breaking
- **2026-06-08** `3a3616091b66`: 58 breaking, 16 warning, 29 info
- **2026-05-27** `4e8048e3afda`: 1 info
- **2026-04-24** `3b8ad911785b`: 2 info
- **2026-02-04** `a8899e7707c4`: 1 info

## Changes

- **2026-10-20** `539f04093540`: 1 warning, 1 info
  - deleted the `header` request parameter `x-api-key`
  - the endpoint scheme security `ApiKeyAuth` was added to the API
- **2026-10-07** `ee3c528838cb`: 1 info
  - added the optional property `browser_settings_receipt` to the response with the `200` status
- **2026-09-25** `66f8cba9377d`: 1 info
  - added the optional property `run_request/anyOf[subschema #1: WorkflowRunRequest]/proxy_location/anyOf[subschema #2: GeoTarget]/isISP` to the response with the `200` status
- **2026-09-15** `272ef19d1017`: 4 info
  - added the optional property `attempt` to the response with the `200` status
  - added the optional property `attempts` to the response with the `200` status
  - added the optional property `next_attempt_at` to the response with the `200` status
  - added the optional property `retry_pending` to the response with the `200` status
- **2026-09-15** `f6a594c58678`: 1 info
  - added the optional property `run_request/anyOf[subschema #1: WorkflowRunRequest]/browser_type` to the response with the `200` status
- **2026-08-22** `89037b86e004`: 1 info
  - added the optional property `run_request/anyOf[subschema #1: WorkflowRunRequest]/file_ids` to the response with the `200` status
- **2026-08-19** `830020b643cd`: 1 info
  - added the optional property `run_request/anyOf[subschema #1: WorkflowRunRequest]/reuse_browser_session` to the response with the `200` status
- **2026-07-24** `bd64e0480f0a`: 3 info
  - added the new optional request property `start_fresh_browser`
  - added the optional property `browser_seed_source` to the response with the `200` status
  - added the optional property `run_request/anyOf[subschema #1: WorkflowRunRequest]/start_fresh_browser` to the response with the `200` status
- **2026-07-20** `b7fa64d35769`: 1 warning
  - added the new `paused` enum value to the `status` response property for the response status `200`
- **2026-06-15** `cd89b4c6f004`: 1 breaking
  - the `run_request/anyOf[subschema #1: WorkflowRunRequest]/max_elapsed_time_minutes/anyOf[subschema #1]/` response property's max was increased from `240.00` to `480.00` for the response status `200`
- **2026-06-08** `3a3616091b66`: 58 breaking, 16 warning, 29 info
  - the request property `browser_address` became not nullable
  - the request property `browser_profile_id` became not nullable
  - the request property `browser_session_id` became not nullable
  - the request property `download_suffix` became not nullable
  - the request property `download_timeout` became not nullable
  - the request property `extra_http_headers` became not nullable
  - the request property `max_screenshot_scrolling_times` became not nullable
  - the request property `max_steps_per_run` became not nullable
  - the request property `proxy_location` became not nullable
  - the request property `totp_identifier` became not nullable
  - the request property `totp_url` became not nullable
  - the request property `url` became not nullable
  - the request property `webhook_url` became not nullable
  - removed the enum value `NONE` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_AR` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_AU` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_BR` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_CA` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_DE` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_ES` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_FR` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_GB` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_IE` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_IN` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_ISP` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_IT` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_JP` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_MX` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_NL` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_NZ` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_PH` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_TR` of the request property `proxy_location`
  - removed the enum value `RESIDENTIAL_ZA` of the request property `proxy_location`
  - removed the enum value `US-CA` of the request property `proxy_location`
  - removed the enum value `US-FL` of the request property `proxy_location`
  - removed the enum value `US-NY` of the request property `proxy_location`
  - removed the enum value `US-TX` of the request property `proxy_location`
  - removed the enum value `US-WA` of the request property `proxy_location`
  - the `proxy_location` request property type changed from `string` to no type
  - …63 more
- **2026-05-27** `4e8048e3afda`: 1 info
  - added the new optional `header` request parameter `x-user-agent`
- **2026-04-24** `3b8ad911785b`: 2 info
  - added the optional property `script_run/script_id` to the response with the `200` status
  - added the optional property `script_run/script_revision_id` to the response with the `200` status
- **2026-02-04** `a8899e7707c4`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/docs/v1/run/tasks/download_files/post.md) - [API](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2.md) - [Page](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/changes/v1/run/tasks/download_files/post)
