Skip to content

Skyvern: contract 2026-10-31

What changed after Skyvern contract 2026-10-31, and the packages that pin it.

Contract 2026-10-31 is a retired Skyvern contract. Alter still runs it for installed SDKs and pending approvals that pin it. Its full operation reference is not published: the API reference documents the current contract, 2026-11-07. See all contracts.

The last release that pins this contract is version 0.1.3: @alter-ai/skyvern 0.1.3 on npm and alter-sdk-skyvern 0.1.3 on PyPI. Each package page documents that release.

The provider’s native API description of this contract, as Alter published it: skyvern.2026-10-31.openapi.json.

This contract has 106 operations. Contract 2026-11-07 added 0, removed 0 and changed 30.

Operation links open the current contract’s reference (2026-11-07).

OperationTypeScriptPythonWhat changed
skyvern.create_browser_session_v1_browser_sessions_postbrowserSessions.createBrowserSessionbrowser_sessions.create_browser_sessionresponse
skyvern.create_credential_v1_credentials_postcredentials.createCredentialcredentials.create_credentialrequest, response
skyvern.create_workflow_v1_agents_postagents.createWorkflowagents.create_workflowrequest, response
skyvern.download_files_v1_run_tasks_download_files_posttasks.downloadFilestasks.download_filesresponse
skyvern.extend_browser_session_v1_browser_sessions_browser_session_id_extend_postbrowserSessions.extendBrowserSessionbrowser_sessions.extend_browser_sessionresponse
skyvern.get_browser_session_v1_browser_sessions_browser_session_id_getbrowserSessions.getBrowserSessionbrowser_sessions.get_browser_sessionresponse
skyvern.get_browser_sessions_v1_browser_sessions_getbrowserSessions.getBrowserSessionsbrowser_sessions.get_browser_sessionsresponse
skyvern.get_credential_v1_credentials_credential_id_getcredentials.getCredentialcredentials.get_credentialresponse
skyvern.get_credentials_v1_credentials_getcredentials.getCredentialscredentials.get_credentialsrequest, response
skyvern.get_folders_v1_folders_getfolders.getFoldersfolders.get_foldersrequest
skyvern.get_run_timeline_v1_runs_run_id_timeline_getruns.getRunTimelineruns.get_run_timelineresponse
skyvern.get_run_v1_runs_run_id_getruns.getRunruns.get_runresponse
skyvern.get_runs_v2_v1_runs_getruns.getRunsV2runs.get_runs_v2request
skyvern.get_scripts_v1_scripts_getscripts.getScriptsscripts.get_scriptsrequest
skyvern.get_workflow_runs_by_id_v1_workflows_workflow_id_runs_getruns.getWorkflowRunsByIdruns.get_workflow_runs_by_idrequest, response
skyvern.get_workflow_runs_v1_workflows_runs_getruns.getWorkflowRunsruns.get_workflow_runsrequest, response
skyvern.get_workflow_v1_workflows_workflow_permanent_id_getagents.getWorkflowagents.get_workflowrequest, response
skyvern.get_workflow_versions_v1_workflows_workflow_permanent_id_versions_getagents.getWorkflowVersionsagents.get_workflow_versionsresponse
skyvern.get_workflows_v1_workflows_getagents.getWorkflowsagents.get_workflowsrequest, response
skyvern.list_browser_profiles_v1_browser_profiles_getbrowserProfiles.listBrowserProfilesbrowser_profiles.list_browser_profilesrequest
skyvern.list_job_recipe_runs_v1_recipes_jobs_runs_getrecipes.listJobRecipeRunsrecipes.list_job_recipe_runsrequest
skyvern.login_v1_run_tasks_login_posttasks.logintasks.loginresponse
skyvern.retry_workflow_run_v1_workflows_runs_workflow_run_id_retry_postruns.retryWorkflowRunruns.retry_workflow_runresponse
skyvern.run_task_v1_run_tasks_posttasks.runTasktasks.run_taskrequest, response
skyvern.run_workflow_v1_run_agents_postruns.runWorkflowruns.run_workflowresponse
skyvern.schedules_list_allschedules.listSchedulesschedules.list_schedulesrequest
skyvern.update_browser_session_v1_browser_sessions_browser_session_id_patchbrowserSessions.updateBrowserSessionbrowser_sessions.update_browser_sessionresponse
skyvern.update_credential_v1_credentials_credential_id_update_postcredentials.updateCredentialcredentials.update_credentialrequest, response
skyvern.update_workflow_folder_v1_workflows_workflow_permanent_id_folder_putfolders.updateWorkflowFolderfolders.update_workflow_folderresponse
skyvern.update_workflow_v1_agents_workflow_id_postagents.updateWorkflowagents.update_workflowrequest, response

Breaking changes in the 2026-11-07 packages

Section titled “Breaking changes in the 2026-11-07 packages”

Skyvern changed these operations upstream, and the current packages follow the provider: code written against the 0.1.3 packages may need a change on upgrading. Each was reviewed when the contract was adopted.

Python methodKindWhat changedWhy
agents.get_workflowInputquery.version: maximum None -> 2147483647
query.version: minimum None -> 1
Skyvern documents a workflow `version` as a positive 32-bit integer (1 to 2,147,483,647); a version outside that range named no workflow.
agents.get_workflowsInputquery.page: maximum None -> 1000000
query.page_size: maximum None -> 1000
Skyvern documents a `page` maximum of 1,000,000 and a `page_size` maximum of 1,000.
browser_profiles.list_browser_profilesInputquery.page: maximum None -> 1000000
query.page_size: maximum None -> 1000
Skyvern documents a `page` maximum of 1,000,000 and a `page_size` maximum of 1,000.
credentials.get_credentialsInputquery.page: maximum None -> 1000000
query.page_size: maximum None -> 1000
Skyvern documents a `page` maximum of 1,000,000 and a `page_size` maximum of 1,000.
folders.get_foldersInputquery.page: maximum None -> 1000000Skyvern documents a `page` maximum of 1,000,000; this list’s `page_size` maximum (500) is unchanged.
recipes.list_job_recipe_runsInputquery.page: maximum None -> 1000000Skyvern documents a `page` maximum of 1,000,000; this list’s `page_size` maximum (100) is unchanged.
runs.get_runs_v2Inputquery.run_type[]: enum values removed "yutori_navigator"Skyvern removed the `yutori_navigator` run type with the `yutori-navigator` engine, so the run-type filter no longer accepts it.
runs.get_workflow_runsInputquery.page: maximum None -> 1000000
query.page_size: maximum None -> 1000
Skyvern documents a `page` maximum of 1,000,000 and a `page_size` maximum of 1,000.
runs.get_workflow_runs_by_idInputquery.page: maximum None -> 1000000
query.page_size: maximum None -> 1000
Skyvern documents a `page` maximum of 1,000,000 and a `page_size` maximum of 1,000.
schedules.list_schedulesInputquery.page: maximum None -> 1000000Skyvern documents a `page` maximum of 1,000,000; this list’s `page_size` maximum (100) is unchanged.
scripts.get_scriptsInputquery.page: maximum None -> 1000000
query.page_size: maximum None -> 1000
Skyvern documents a `page` maximum of 1,000,000 and a `page_size` maximum of 1,000.
tasks.run_taskInputbody.engine: enum values removed "yutori-navigator"Skyvern removed the `yutori-navigator` engine.

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.