---
title: "Changes to Run a task"
method: POST
path: "/v1/run/tasks"
---

# Changes to Run a task

`POST /v1/run/tasks`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 15 of 79 revisions.

- **2026-10-08** `04df18172f4d`: 8 info
- **2026-09-10** `463442d35b74`: 1 warning
- **2026-08-23** `1a7ff4f208ff`: 1 warning, 1 info
- **2026-07-20** `645819945b7b`: 1 warning
- **2026-06-07** `e37d309fc58f`: 2 info
- **2026-05-28** `172f5de044f2`: 5 info
- **2026-05-26** `c843fbca7486`: 2 info
- **2026-05-25** `2b25d859ea87`: 1 warning
- **2026-05-09** `9a8565aaedbf`: 1 warning, 3 info
- **2026-05-09** `f97d3f2efafe`: 1 breaking, 2 warning, 1 info
- **2026-05-09** `9a8565aaedbf`: 1 warning, 3 info
- **2026-04-24** `0438e38c54cb`: 2 info
- **2026-04-13** `85a4ba66dad1`: 2 info
- **2026-04-13** `5c0ca63adfe4`: 2 info
- **2026-04-13** `85a4ba66dad1`: 2 info

## Changes

- **2026-10-08** `04df18172f4d`: 8 info
  - added the new optional request property `browser_profile_id`
  - added the new optional request property `file_ids`
  - added the new optional request property `proxy_location/anyOf[subschema #2: GeoTarget]/isISP`
  - added the new optional request property `start_fresh_browser`
  - added the optional property `run_request/anyOf[subschema #1: TaskRunRequest]/browser_profile_id` to the response with the `200` status
  - added the optional property `run_request/anyOf[subschema #1: TaskRunRequest]/file_ids` to the response with the `200` status
  - added the optional property `run_request/anyOf[subschema #1: TaskRunRequest]/proxy_location/anyOf[subschema #2: GeoTarget]/isISP` to the response with the `200` status
  - added the optional property `run_request/anyOf[subschema #1: TaskRunRequest]/start_fresh_browser` to the response with the `200` status
- **2026-09-10** `463442d35b74`: 1 warning
  - added the new `task_v3` enum value to the `run_type` response property for the response status `200`
- **2026-08-23** `1a7ff4f208ff`: 1 warning, 1 info
  - added the new `skyvern-3.0` enum value to the `run_request/anyOf[subschema #1: TaskRunRequest]/engine` response property for the response status `200`
  - added the new `skyvern-3.0` enum value to the request property `engine`
- **2026-07-20** `645819945b7b`: 1 warning
  - added the new `paused` enum value to the `status` response property 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 new `yutori-navigator` enum value to the request property `engine`
  - added the optional property `recording_archived` to the response with the `200` status
  - added `#/components/schemas/TaskRunRequest-Output` to the `run_request` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/TaskRunRequest` from the `run_request` response property `anyOf` list for the response status `200`
- **2026-05-26** `c843fbca7486`: 2 info
  - request property `publish_workflow` deprecated
  - response property `run_request/anyOf[subschema #1: TaskRunRequest]/publish_workflow` deprecated
- **2026-05-25** `2b25d859ea87`: 1 warning
  - added the new `yutori_navigator` enum value to the `run_type` response property for the response status `200`
- **2026-05-09** `9a8565aaedbf`: 1 warning, 3 info
  - added the new `RESIDENTIAL_SA` enum value to the `run_request/anyOf[subschema #1: TaskRunRequest]/proxy_location/anyOf[subschema #1: ProxyLocation]/` response property for the response status `200`
  - 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, 2 warning, 1 info
  - removed the enum value `RESIDENTIAL_SA` of the request property `proxy_location/anyOf[subschema #1: ProxyLocation]/`
  - 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: TaskRunRequest]/proxy_location/anyOf[subschema #1: ProxyLocation]/` response property for the response status `200`
- **2026-05-09** `9a8565aaedbf`: 1 warning, 3 info
  - added the new `RESIDENTIAL_SA` enum value to the `run_request/anyOf[subschema #1: TaskRunRequest]/proxy_location/anyOf[subschema #1: ProxyLocation]/` response property for the response status `200`
  - 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-04-13** `85a4ba66dad1`: 2 info
  - the `engine` request property default value changed from `skyvern-2.0` to `skyvern-1.0`
  - the `engine` response's property default value changed from `skyvern-2.0` to `skyvern-1.0` for the status `200`
- **2026-04-13** `5c0ca63adfe4`: 2 info
  - the `engine` request property default value changed from `skyvern-1.0` to `skyvern-2.0`
  - the `engine` response's property default value changed from `skyvern-1.0` to `skyvern-2.0` for the status `200`
- **2026-04-13** `85a4ba66dad1`: 2 info
  - the `engine` request property default value changed from `skyvern-2.0` to `skyvern-1.0`
  - the `engine` response's property default value changed from `skyvern-2.0` to `skyvern-1.0` for the status `200`

---

[Operation](https://skmtc.dev/skyvern-ai/apis/skyvern-api/docs/v1/run/tasks/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/post)