---
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 13 of 79 revisions.

- **2026-10-08** `04df18172f4d`: 12 info
- **2026-07-20** `645819945b7b`: 1 warning
- **2026-06-15** `cd89b4c6f004`: 1 breaking
- **2026-06-07** `e37d309fc58f`: 2 info
- **2026-05-28** `172f5de044f2`: 5 info
- **2026-05-13** `becdfa4d5ab3`: 1 info
- **2026-05-09** `9a8565aaedbf`: 1 warning, 4 info
- **2026-05-09** `f97d3f2efafe`: 1 breaking, 3 warning, 1 info
- **2026-05-09** `9a8565aaedbf`: 1 warning, 4 info
- **2026-04-24** `0438e38c54cb`: 2 info
- **2026-03-30** `8a4e8b880de8`: 2 info
- **2026-03-29** `d70a0640ef29`: 1 breaking, 1 info
- **2026-03-29** `8a4e8b880de8`: 2 info

## Changes

- **2026-10-08** `04df18172f4d`: 12 info
  - added the new optional request property `start_fresh_browser`
  - 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 `browser_seed_source` to the response with the `200` status
  - added the optional property `browser_settings_receipt` 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
  - added the optional property `run_request/anyOf[subschema #1: WorkflowRunRequest]/browser_type` to the response with the `200` status
  - added the optional property `run_request/anyOf[subschema #1: WorkflowRunRequest]/file_ids` to the response with the `200` status
  - added the optional property `run_request/anyOf[subschema #1: WorkflowRunRequest]/proxy_location/anyOf[subschema #2: GeoTarget]/isISP` to the response with the `200` status
  - added the optional property `run_request/anyOf[subschema #1: WorkflowRunRequest]/reuse_browser_session` 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** `645819945b7b`: 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-07** `e37d309fc58f`: 2 info
  - api tag `Agents` added
  - api tag `Agent` removed
- **2026-05-28** `172f5de044f2`: 5 info
  - added the new optional request property `cdp_connect_headers`
  - added the optional property `recording_archived` to the response with the `200` status
  - added the optional property `script_id` to the response with the `200` status
  - added `#/components/schemas/WorkflowRunRequest-Output` to the `run_request` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/WorkflowRunRequest` from the `run_request` response property `anyOf` list for the response status `200`
- **2026-05-13** `becdfa4d5ab3`: 1 info
  - added the optional property `run_request/anyOf[subschema #1: WorkflowRunRequest]/run_metadata` to the response with the `200` status
- **2026-05-09** `9a8565aaedbf`: 1 warning, 4 info
  - added the new `RESIDENTIAL_SA` enum value to the `run_request/anyOf[subschema #1: WorkflowRunRequest]/proxy_location/anyOf[subschema #1: ProxyLocation]/` response property for the response status `200`
  - added the new optional `header` request parameter `x-user-agent`
  - added the new `RESIDENTIAL_SA` enum value to the request property `proxy_location/anyOf[subschema #1: ProxyLocation]/`
  - added the optional property `downloaded_files/anyOf[subschema #1]/items/artifact_id` to the response with the `200` status
  - added the optional property `downloaded_files/anyOf[subschema #1]/items/file_size` to the response with the `200` status
- **2026-05-09** `f97d3f2efafe`: 1 breaking, 3 warning, 1 info
  - removed the enum value `RESIDENTIAL_SA` of the request property `proxy_location/anyOf[subschema #1: ProxyLocation]/`
  - deleted the `header` request parameter `x-user-agent`
  - removed the optional property `downloaded_files/anyOf[subschema #1]/items/artifact_id` from the response with the `200` status
  - removed the optional property `downloaded_files/anyOf[subschema #1]/items/file_size` from the response with the `200` status
  - removed the `RESIDENTIAL_SA` enum value from the `run_request/anyOf[subschema #1: WorkflowRunRequest]/proxy_location/anyOf[subschema #1: ProxyLocation]/` response property for the response status `200`
- **2026-05-09** `9a8565aaedbf`: 1 warning, 4 info
  - added the new `RESIDENTIAL_SA` enum value to the `run_request/anyOf[subschema #1: WorkflowRunRequest]/proxy_location/anyOf[subschema #1: ProxyLocation]/` response property for the response status `200`
  - added the new optional `header` request parameter `x-user-agent`
  - added the new `RESIDENTIAL_SA` enum value to the request property `proxy_location/anyOf[subschema #1: ProxyLocation]/`
  - added the optional property `downloaded_files/anyOf[subschema #1]/items/artifact_id` to the response with the `200` status
  - added the optional property `downloaded_files/anyOf[subschema #1]/items/file_size` to the response with the `200` status
- **2026-04-24** `0438e38c54cb`: 2 info
  - added the optional property `script_run/anyOf[subschema #1: ScriptRunResponse]/script_id` to the response with the `200` status
  - added the optional property `script_run/anyOf[subschema #1: ScriptRunResponse]/script_revision_id` to the response with the `200` status
- **2026-03-30** `8a4e8b880de8`: 2 info
  - the `run_with` response's property default value `agent` was added for the status `200`
  - response property `run_with` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
- **2026-03-29** `d70a0640ef29`: 1 breaking, 1 info
  - response property `run_with` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `run_with` response's property default value `agent` was removed for the status `200`
- **2026-03-29** `8a4e8b880de8`: 2 info
  - the `run_with` response's property default value `agent` was added for the status `200`
  - response property `run_with` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`

---

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