--- 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 endpoint, newest first. ## Timeline Changed in 13 of 86 revisions. - **2026-08-22** `89037b86e004` — 2 info - **2026-08-13** `0c5e6f1a3df9` — 2 warning, 1 info - **2026-07-24** `bd64e0480f0a` — 4 info - **2026-07-20** `b7fa64d35769` — 1 warning - **2026-06-08** `3a3616091b66` — 35 breaking, 21 warning, 33 info - **2026-05-26** `c1f6a1464e64` — 4 info - **2026-05-25** `ec25ca3a20bb` — 1 warning - **2026-04-24** `3b8ad911785b` — 2 info - **2026-04-23** `a8899e7707c4` — 2 info - **2026-04-22** `446a00cd1eec` — 2 info - **2026-04-15** `a8899e7707c4` — 2 info - **2026-04-15** `446a00cd1eec` — 2 info - **2026-02-04** `a8899e7707c4` — 1 info ## Changes - **2026-08-22** `89037b86e004` — 2 info - added the new optional request property `file_ids` - added the optional property `run_request/anyOf[subschema #1: TaskRunRequest]/file_ids` to the response with the `200` status - **2026-08-13** `0c5e6f1a3df9` — 2 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 `task_v3` enum value to the `run_type` response property for the response status `200` - added the new `skyvern-3.0` enum value to the request property `engine` - **2026-07-24** `bd64e0480f0a` — 4 info - added the new optional request property `browser_profile_id` - 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]/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-08** `3a3616091b66` — 35 breaking, 21 warning, 33 info - the request property `browser_address` became not nullable - the request property `browser_session_id` became not nullable - the request property `data_extraction_schema` became not nullable - the request property `error_code_mapping` became not nullable - the request property `extra_http_headers` became not nullable - the request property `include_action_history_in_verification` became not nullable - the request property `max_screenshot_scrolls` became not nullable - the request property `max_steps` became not nullable - the request property `model` became not nullable - the request property `proxy_location` became not nullable - the request property `proxy_location/anyOf[subschema #2: GeoTarget]/city` became not nullable - the request property `proxy_location/anyOf[subschema #2: GeoTarget]/subdivision` became not nullable - the request property `run_with` became not nullable - the request property `title` 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 - response property `app_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `browser_profile_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `browser_session_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `downloaded_files` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `errors` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `failure_reason` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `finished_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `max_screenshot_scrolls` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `output` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `queued_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `recording_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `screenshot_urls` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `started_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `step_count` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - the `run_request` response's property type changed from `object` to no type for status `200` - the `script_run` response's property type changed from `object` to no type for status `200` - removed the required property `run_request/prompt` from the response with the `200` status - removed the optional property `run_request/browser_address` from the response with the `200` status - removed the optional property `run_request/browser_session_id` from the response with the `200` status - removed the optional property `run_request/data_extraction_schema` from the response with the `200` status - removed the optional property `run_request/engine` from the response with the `200` status - removed the optional property `run_request/error_code_mapping` from the response with the `200` status - …49 more - **2026-05-26** `c1f6a1464e64` — 4 info - the `engine` request property default value changed from `skyvern-2.0` to `skyvern-1.0` - request property `publish_workflow` deprecated - the `engine` response's property default value changed from `skyvern-2.0` to `skyvern-1.0` for the status `200` - response property `run_request/publish_workflow` deprecated - **2026-05-25** `ec25ca3a20bb` — 1 warning - added the new `yutori_navigator` enum value to the `run_type` response property for the response status `200` - **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-04-23** `a8899e7707c4` — 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-22** `446a00cd1eec` — 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-15** `a8899e7707c4` — 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-15** `446a00cd1eec` — 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-02-04** `a8899e7707c4` — 1 info - endpoint added --- [Operation](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/docs/v1/run/tasks/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/post)