Changes to Run a task

Changed in 13 of the 86 revisions of this API.▲35●25○55

1. Aug 22, 202689037b86e004○2
2. Aug 13, 20260c5e6f1a3df9●2○1
3. Jul 24, 2026bd64e0480f0a○4
4. Jul 20, 2026b7fa64d35769●1
5. Jun 8, 20263a3616091b66▲35●21○33
6. May 26, 2026c1f6a1464e64○4
7. May 25, 2026ec25ca3a20bb●1
8. Apr 24, 20263b8ad911785b○2
9. Apr 23, 2026a8899e7707c4○2
10. Apr 22, 2026446a00cd1eec○2
11. Apr 15, 2026a8899e7707c4○2
12. Apr 15, 2026446a00cd1eec○2
13. Feb 4, 2026a8899e7707c4○1

What changed

• Aug 22, 202689037b86e004○2See the full diff
  • ○

    added the new optional request property file_ids

    new-optional-request-property

  • ○

    added the optional property run_request/anyOf[subschema #1: TaskRunRequest]/file_ids to the response with the 200 status

    response-optional-property-added

• Aug 13, 20260c5e6f1a3df9●2○1See the full diff
  • ●

    added the new skyvern-3.0 enum value to the run_request/anyOf[subschema #1: TaskRunRequest]/engine response property for the response status 200

    response-property-enum-value-added

  • ●

    added the new task_v3 enum value to the run_type response property for the response status 200

    response-property-enum-value-added

  • ○

    added the new skyvern-3.0 enum value to the request property engine

    request-property-enum-value-added

• Jul 24, 2026bd64e0480f0a○4See the full diff
  • ○

    added the new optional request property browser_profile_id

    new-optional-request-property

  • ○

    added the new optional request property start_fresh_browser

    new-optional-request-property

  • ○

    added the optional property run_request/anyOf[subschema #1: TaskRunRequest]/browser_profile_id to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property run_request/anyOf[subschema #1: TaskRunRequest]/start_fresh_browser to the response with the 200 status

    response-optional-property-added

• Jul 20, 2026b7fa64d35769●1See the full diff
  • ●

    added the new paused enum value to the status response property for the response status 200

    response-property-enum-value-added

• Jun 8, 20263a3616091b66▲35●21○33See the full diff
  • ▲

    the request property browser_address became not nullable

    request-property-became-not-nullable

  • ▲

    the request property browser_session_id became not nullable

    request-property-became-not-nullable

  • ▲

    the request property data_extraction_schema became not nullable

    request-property-became-not-nullable

  • ▲

    the request property error_code_mapping became not nullable

    request-property-became-not-nullable

  • ▲

    the request property extra_http_headers became not nullable

    request-property-became-not-nullable

  • ▲

    the request property include_action_history_in_verification became not nullable

    request-property-became-not-nullable

  • ▲

    the request property max_screenshot_scrolls became not nullable

    request-property-became-not-nullable

  • ▲

    the request property max_steps became not nullable

    request-property-became-not-nullable

  • ▲

    the request property model became not nullable

    request-property-became-not-nullable

  • ▲

    the request property proxy_location became not nullable

    request-property-became-not-nullable

  • ▲

    the request property proxy_location/anyOf[subschema #2: GeoTarget]/city became not nullable

    request-property-became-not-nullable

  • ▲

    the request property proxy_location/anyOf[subschema #2: GeoTarget]/subdivision became not nullable

    request-property-became-not-nullable

  • ▲

    the request property run_with became not nullable

    request-property-became-not-nullable

  • ▲

    the request property title became not nullable

    request-property-became-not-nullable

  • ▲

    the request property totp_identifier became not nullable

    request-property-became-not-nullable

  • ▲

    the request property totp_url became not nullable

    request-property-became-not-nullable

  • ▲

    the request property url became not nullable

    request-property-became-not-nullable

  • ▲

    the request property webhook_url became not nullable

    request-property-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-list-of-types-widened

  • ▲

    response property browser_profile_id list-of-types was widened by adding types null to media type application/json of response 200

    response-property-list-of-types-widened

  • ▲

    response property browser_session_id list-of-types was widened by adding types null to media type application/json of response 200

    response-property-list-of-types-widened

  • ▲

    response property downloaded_files list-of-types was widened by adding types null to media type application/json of response 200

    response-property-list-of-types-widened

  • ▲

    response property errors list-of-types was widened by adding types null to media type application/json of response 200

    response-property-list-of-types-widened

  • ▲

    response property failure_reason list-of-types was widened by adding types null to media type application/json of response 200

    response-property-list-of-types-widened

  • ▲

    response property finished_at list-of-types was widened by adding types null to media type application/json of response 200

    response-property-list-of-types-widened

  • ▲

    response property max_screenshot_scrolls list-of-types was widened by adding types null to media type application/json of response 200

    response-property-list-of-types-widened

  • ▲

    response property output list-of-types was widened by adding types null to media type application/json of response 200

    response-property-list-of-types-widened

  • ▲

    response property queued_at list-of-types was widened by adding types null to media type application/json of response 200

    response-property-list-of-types-widened

  • ▲

    response property recording_url list-of-types was widened by adding types null to media type application/json of response 200

    response-property-list-of-types-widened

  • ▲

    response property screenshot_urls list-of-types was widened by adding types null to media type application/json of response 200

    response-property-list-of-types-widened

  • ▲

    response property started_at list-of-types was widened by adding types null to media type application/json of response 200

    response-property-list-of-types-widened

  • ▲

    response property step_count list-of-types was widened by adding types null to media type application/json of response 200

    response-property-list-of-types-widened

  • ▲

    the run_request response's property type changed from object to no type for status 200

    response-property-type-changed

  • ▲

    the script_run response's property type changed from object to no type for status 200

    response-property-type-changed

  • ▲

    removed the required property run_request/prompt from the response with the 200 status

    response-required-property-removed

  • ●

    removed the optional property run_request/browser_address from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/browser_session_id from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/data_extraction_schema from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/engine from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/error_code_mapping from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/extra_http_headers from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/include_action_history_in_verification from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/max_screenshot_scrolls from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/max_steps from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/model from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/proxy_location from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/publish_workflow from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/run_with from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/title from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/totp_identifier from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/totp_url from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/url from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property run_request/webhook_url from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property script_run/ai_fallback_triggered from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property script_run/script_id from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property script_run/script_revision_id from the response with the 200 status

    response-optional-property-removed

  • ○

    api tag Agents added

    api-tag-added

  • ○

    api tag Agent removed

    api-tag-removed

  • ○

    added the new optional request property cdp_connect_headers

    new-optional-request-property

  • ○

    header request parameter x-api-key list-of-types was widened by adding types null

    request-parameter-list-of-types-widened

  • ○

    header request parameter x-user-agent list-of-types was widened by adding types null

    request-parameter-list-of-types-widened

  • ○

    for the header request parameter x-api-key, the type was generalized from string to no type

    request-parameter-type-generalized

  • ○

    for the header request parameter x-user-agent, the type was generalized from string to no type

    request-parameter-type-generalized

  • ○

    added subschema #4 to the proxy_location request property anyOf list

    request-property-any-of-added

  • ○

    added the new RESIDENTIAL_KR enum value to the request property proxy_location/anyOf[subschema #1: ProxyLocation]

    request-property-enum-value-added

  • ○

    added the new RESIDENTIAL_SA enum value to the request property proxy_location/anyOf[subschema #1: ProxyLocation]

    request-property-enum-value-added

  • ○

    added the new yutori-navigator enum value to the request property engine

    request-property-enum-value-added

  • ○

    request property browser_address list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property browser_session_id list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property data_extraction_schema list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property error_code_mapping list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property extra_http_headers list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property include_action_history_in_verification list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property max_screenshot_scrolls list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property max_steps list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property model list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property proxy_location/anyOf[subschema #2: GeoTarget]/city list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property proxy_location/anyOf[subschema #2: GeoTarget]/subdivision list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property run_with list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property title list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property totp_identifier list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property totp_url list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property url list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    request property webhook_url list-of-types was widened by adding types null to media type application/json

    request-property-list-of-types-widened

  • ○

    added the optional property detail/items/ctx to the response with the 422 status

    response-optional-property-added

  • ○

    added the optional property detail/items/input to the response with the 422 status

    response-optional-property-added

  • ○

    added the optional property recording_archived to the response with the 200 status

    response-optional-property-added

  • ○

    added ScriptRunResponse subschema #2 to the script_run response property anyOf list for the response status 200

    response-property-any-of-added

  • ○

    added TaskRunRequest-Output subschema #2 to the run_request response property anyOf list for the response status 200

    response-property-any-of-added

  This revision also has 10 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• May 26, 2026c1f6a1464e64○4See the full diff
  • ○

    the engine request property default value changed from skyvern-2.0 to skyvern-1.0

    request-property-default-value-changed

  • ○

    request property publish_workflow deprecated

    request-property-deprecated

  • ○

    the engine response's property default value changed from skyvern-2.0 to skyvern-1.0 for the status 200

    response-property-default-value-changed

  • ○

    response property run_request/publish_workflow deprecated

    response-property-deprecated

• May 25, 2026ec25ca3a20bb●1See the full diff
  • ●

    added the new yutori_navigator enum value to the run_type response property for the response status 200

    response-property-enum-value-added

• Apr 24, 20263b8ad911785b○2See the full diff
  • ○

    added the optional property script_run/script_id to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property script_run/script_revision_id to the response with the 200 status

    response-optional-property-added

• Apr 23, 2026a8899e7707c4○2See the full diff
  • ○

    the engine request property default value changed from skyvern-1.0 to skyvern-2.0

    request-property-default-value-changed

  • ○

    the engine response's property default value changed from skyvern-1.0 to skyvern-2.0 for the status 200

    response-property-default-value-changed

  This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• Apr 22, 2026446a00cd1eec○2See the full diff
  • ○

    the engine request property default value changed from skyvern-2.0 to skyvern-1.0

    request-property-default-value-changed

  • ○

    the engine response's property default value changed from skyvern-2.0 to skyvern-1.0 for the status 200

    response-property-default-value-changed

• Apr 15, 2026a8899e7707c4○2See the full diff
  • ○

    the engine request property default value changed from skyvern-1.0 to skyvern-2.0

    request-property-default-value-changed

  • ○

    the engine response's property default value changed from skyvern-1.0 to skyvern-2.0 for the status 200

    response-property-default-value-changed

  This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

• Apr 15, 2026446a00cd1eec○2See the full diff
  • ○

    the engine request property default value changed from skyvern-2.0 to skyvern-1.0

    request-property-default-value-changed

  • ○

    the engine response's property default value changed from skyvern-2.0 to skyvern-1.0 for the status 200

    response-property-default-value-changed

• Feb 4, 2026a8899e7707c4○1See the full diff
  • ○

    endpoint added

    endpoint-added

  This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog