NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #1391 most downloaded on PyPI
Workflow orchestration and management.
Latest stable
3.9.2
Last release 12 days ago
10 Nov 2026
Ships on a steady schedule
a new release about every 8 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
3 versions withdrawn
withdrawn after publishing
8 years old
922 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.8.dev2...3.6.8.dev3
*Released on December 18, 2025*
Released on December 18, 2025
Enhancements ➕➕
Variable.get method by @devin-ai-integration[bot] in #19764late_runs service to Docket perpetual function by @zzstoatzz in #19722repossessor service to Docket perpetual function by @zzstoatzz in #19739foreman service to Docket perpetual function by @zzstoatzz in #19741telemetry service to Docket perpetual function by @zzstoatzz in #19754LoopService by @zzstoatzz in #19756Bug Fixes 🐞
docket.worker logger by @devin-ai-integration[bot] in #19772grace_period_seconds from deployment concurrency_options by @zzstoatzz in #19784docket_url setting path to server.docket.url by @zzstoatzz in #19791Development & Tidiness 🧹
Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.6...3.6.7
Your coding agent can read these notes before it upgrades. Set up the MCP server →
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.7.dev2...3.6.7.dev3
*Released on December 08, 2025*
Released on December 08, 2025
Enhancements ➕➕
search_path support via settings by @devin-ai-integration[bot] in #19620cancellation_cleanup to perpetual Docket task by @zzstoatzz in #19715pause_expirations service to perpetual Docket task by @zzstoatzz in #19719Bug Fixes 🐞
result_storage usage with @task and @flow decorators by @devin-ai-integration[bot] in #19671DEFAULT cache policy from triggering automatic persist_result by @devin-ai-integration[bot] in #19673history_interval_seconds as parameter name in OpenAPI schema by @desertaxle in #19659Development & Tidiness 🧹
prefect.input.actions from sync_compatible to async_dispatch by @zzstoatzz in #19632Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.5...3.6.6
Update sucrase to remove vulnerable glob dependency by @zzstoatzz in #19599
Released on December 04, 2025
Enhancements ➕➕
Path objects in result_storage parameter by @zzstoatzz in #19533xreadgroup batch size in consumer and add EventPersister service setting by @saschwartz in #19545xautoclaim batch size by @saschwartz in #19557TaskRunRecorder and Trigger service message read batch size by @saschwartz in #19559SlackWebhook block by @devin-ai-integration[bot] in #19565job_variables in workers by @devin-ai-integration[bot] in #19619Bug Fixes 🐞
username:password auth for self-hosted BitBucket instances by @zzstoatzz in #19516/api/task_runs/count endpoint performance by @naaa760 in #19548fastapi==0.123.7 by @desertaxle in #19626launchType for capacity providers by @zzstoatzz in #19630Integrations & Dependencies 🤝
Development & Tidiness 🧹
pytest-asyncio to fix 3.10 client tests by @desertaxle in #19609TestReadTaskRunCountsByState::test_returns_all_state_types by @desertaxle in #19612Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.4...3.6.5
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
prefect-redis==0.2.7 by @zzstoatzz in https://github.com/PrefectHQ/prefect/pull/19561Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.5.dev3...3.6.5.dev4
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.5.dev2...3.6.5.dev3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.5.dev1...3.6.5.dev2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.4...3.6.5.dev1
fix: preserve event template parameters in deployment triggers by @zzstoatzz in #19504
Bug Fixes 🐞
Integrations & Dependencies 🤝
Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.3...3.6.4
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.3...3.6.4.dev1
Add -o json output option to prefect flow-run ls command by @devin-ai-integration[bot] in #19484
Enhancements ➕➕
-o json output option to prefect flow-run ls command by @devin-ai-integration[bot] in #19484Bug Fixes 🐞
Development & Tidiness 🧹
Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.2...3.6.3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.3.dev2...3.6.3.dev3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.3.dev1...3.6.3.dev2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.2...3.6.3.dev1
Add causal link from automation action events to triggering events by @zzstoatzz in #19426
Enhancements ➕
Bug Fixes 🐞
Development & Tidiness 🧹
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.1...3.6.2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.1...3.6.2.dev1
Add client methods for querying events via REST API by @zzstoatzz in #19382
Enhancements ➕
Bug Fixes 🐞
Integrations & Dependencies 🤝
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.0...3.6.1
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.0...3.6.1.dev1
This release adds `pydocket`, a background task system, to replace FastAPI's background_tasks. Background tasks now include automatic retries and can
This release adds pydocket, a background task system, to replace FastAPI's background_tasks. Background tasks now include automatic retries and can optionally use Redis as a backing layer for enhanced durable execution.
Released on November 07, 2025
Enhancements ➕➕
background_task usage with pydocket by @desertaxle in #19377Bug Fixes 🐞
deployment.parameters in subprocess flows by @zzstoatzz in #19331pyright error when calling async task with wrong argument types by @zzstoatzz in #19327EventsWorker singleton leak in prefect_test_harness by @zzstoatzz in #19343run_deployment execution graph display when called from tasks by @desertaxle in #19361Integrations & Dependencies 🤝
prefect-ui-library to latest version by @znicholasbrown in #19350Development & Tidiness 🧹
RedisStorageContainer from sync_compatible to async_dispatch by @devin-ai-integration[bot] in #19363Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.5.0...3.6.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.5.1.dev3...3.5.1.dev4
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
run_deployment execution graph display when called from tasks by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19361Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.5.1.dev2...3.5.1.dev3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
run_task API Call by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19335Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.5.1.dev1...3.5.1.dev2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.5.0...3.5.1.dev1
…functionality and system Blocks. Check the Breaking Changes section below for details.
Released on October 31, 2025
With the removal of Python 3.9 support, Prefect now requires Python 3.10 or later. This means you can finally say goodbye to from __future__ import annotations in your workflow code—native type annotations are now standard! This release also removes several long-deprecated features, including Runner functionality and system Blocks. Check the Breaking Changes section below for details.
Enhancements ➕➕
on_running hook support for tasks by @zzstoatzz in #19277PREFECT_SERVER_UI_SHOW_PROMOTIONAL_CONTENT setting by @zzstoatzz in #19299Breaking Changes ⚠️
Runner functionality and system Blocks by @desertaxle in #19307Bug Fixes 🐞
ValidatedFunction by @desertaxle in #19289datetime parameter serialization in run_deployment by @zzstoatzz in #19278prefect_test_harness on Linux by @zzstoatzz in #19116Development & Tidiness 🧹
typer minimum to 0.16.0 for click>=8.2 compatibility by @zzstoatzz in #19269just recipes to use 3.10 for lowest python by @zzstoatzz in #19297generate_deprecation_message by @desertaxle in #19314RRuleSchedule test flakiness from DST-dependent date by @zzstoatzz in #19305Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.25...3.5.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.26.dev5...3.4.26.dev6
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.26.dev4...3.4.26.dev5
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
PREFECT_SERVER_UI_SHOW_PROMOTIONAL_CONTENT setting by @zzstoatzz in https://github.com/PrefectHQ/prefect/pull/19299Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.26.dev3...3.4.26.dev4
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
ValidatedFunction by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19289Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.26.dev2...3.4.26.dev3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
prefect-aws image builds by @jamiezieziula in https://github.com/PrefectHQ/prefect/pull/19274Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.26.dev1...3.4.26.dev2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.25...3.4.26.dev1
Upgrade Docker image SQLite to 3.50.4 to address CVE-2025-6965 by @desertaxle in #19214
Released on October 23, 2025
Enhancements ➕➕
Bug Fixes 🐞
MemoryLockManager serializable with cloudpickle by @desertaxle in #19246Development & Tidiness 🧹
generate-cli-docs to justfile by @desertaxle in #19245uv and gh as allowed tools for Claude in GitHub Actions by @desertaxle in #19210Documentation 📓
--limit argument documentation by @desertaxle in #19244pydantic-ai data analyst example by @desertaxle in #19209Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.24...3.4.25
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
--limit argument documentation by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19244MemoryLockManager serializable with cloudpickle by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19246generate-cli-docs to justfile by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19245Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.25.dev4...3.4.25.dev5
Upgrade Docker image SQLite to 3.50.4 to address CVE-2025-6965 by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19214
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.25.dev3...3.4.25.dev4
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.25.dev2...3.4.25.dev3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
pydantic-ai data analyst example by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19209uv and gh as allowed tools for Claude in GitHub Actions by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19210Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.25.dev1...3.4.25.dev2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
prefect-azure==0.4.6 by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19202prefect-redis==0.2.6 release by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19204Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.24...3.4.25.dev1
Add flow run watching with interleaved events and logs by @chrisguidry in #19158
Released on October 16, 2025
Enhancements ➕➕
--all flag to prefect automation delete by @zzstoatzz in #19164Experimental 🧪
Bug Fixes 🐞
ProcessPoolTaskRunner when submitting with wait_for by @desertaxle in #19172from_storage and afrom_storage by @zzstoatzz in #19179RunInput.with_initial_data to preserve type annotations by @zzstoatzz in #19176Development & Tidiness 🧹
websocket_connect import in proxy test script by @zzstoatzz in #19161prefect.states exception handlers to async_dispatch by @zzstoatzz in #19170Documentation 📓
build_docker_image accepts all Docker SDK kwargs by @zzstoatzz in #19194Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.23...3.4.24
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.24.dev4...3.4.24.dev5
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
ProcessPoolTaskRunner when submitting with wait_for by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19172prefect-aws==0.6.0 by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19168RunInput.with_initial_data to preserve type annotations by @zzstoatzz in https://github.com/PrefectHQ/prefect/pull/19176Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.24.dev3...3.4.24.dev4
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.24.dev2...3.4.24.dev3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.24.dev1...3.4.24.dev2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.23...3.4.24.dev1
feat(client): allow using custom SSL contexts by @fatih-acar in #19106
Released on October 09, 2025
Enhancements ➕➕
prefect api command for direct API access by @chrisguidry in #19131Bug Fixes 🐞
timeout_async context manager by @desertaxle in #19101Development & Tidiness 🧹
Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.22...3.4.23
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.23.dev2...3.4.23.dev3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.23.dev1...3.4.23.dev2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
timeout_async context manager by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19101Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.22...3.4.23.dev1
Fix startup errors when installed with pydantic 2.10 and Python 3.9 and 3.10 by @desertaxle in #19095
Bug Fixes 🐞
pydantic 2.10 and Python 3.9 and 3.10 by @desertaxle in #19095Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.21...3.4.22
Add automatic local dependency discovery for flow bundles by @desertaxle in #19043
Released on October 02, 2025
Enhancements ➕➕
Bug Fixes 🐞
KeyError when running deployment without parameter schema by @zzstoatzz in #19055PREFECT_CLIENT_CUSTOM_HEADERS JSON string parsing by @zzstoatzz in #19052TTLCache for memory-based CausalOrdering to prevent memory leaks by @desertaxle in #19061application_name setting by @zzstoatzz in #19081Development & Tidiness 🧹
graphviz, bump typer, update lockfile by @zzstoatzz in #19051server.concurrency.initial_lease_timeout to server.concurrency.initial_deployment_lease_duration by @desertaxle in #19085parameter_openapi_schema to valid OpenAPI format by @zzstoatzz in #19072DeploymentCreate.parameter_openapi_schema field Optional by @zzstoatzz in #19089Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.20...3.4.21
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.21.dev4...3.4.21.dev5
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
PREFECT_CLIENT_CUSTOM_HEADERS JSON string parsing by @zzstoatzz in https://github.com/PrefectHQ/prefect/pull/19052Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.21.dev3...3.4.21.dev4
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
graphviz, bump typer, update lockfile by @zzstoatzz in https://github.com/PrefectHQ/prefect/pull/19051Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.21.dev2...3.4.21.dev3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.21.dev1...3.4.21.dev2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.20...3.4.21.dev1
*Released on September 25, 2025*
Released on September 25, 2025
Enhancements ➕➕
Bug Fixes 🐞
FlowRunCancellingObserver by @desertaxle in #19017pydantic-settings 2.11+ compatibility warnings by @zzstoatzz in #19029Development & Tidiness 🧹
Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.19...3.4.20
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
FlowRunCancellingObserver by @desertaxle in https://github.com/PrefectHQ/prefect/pull/19017Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.20.dev1...3.4.20.dev2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.19...3.4.20.dev1
*Released on September 19, 2025*
Released on September 19, 2025
Enhancements ➕➕
deploy.py into a module by @zzstoatzz in #18925read_active_lease_ids by @zzstoatzz in #18973list_holders_for_limit to ConcurrencyLeaseStorage protocol by @zzstoatzz in #18970Bug Fixes 🐞
set_working_directory to return absolute path by @desertaxle in #18932wait() to monitor all futures concurrently with timeout by @zzstoatzz in #18960Development & Tidiness 🧹
prefect.yaml files by @desertaxle in #18941mdxify explicitly in CI by @desertaxle in #18954Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.18...3.4.19
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.19.dev4...3.4.19.dev5
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
workflow_dispatch trigger to docs auto-generation workflow for testing by @desertaxle in https://github.com/PrefectHQ/prefect/pull/18966prefect-kubernetes==0.6.5 by @desertaxle in https://github.com/PrefectHQ/prefect/pull/18975list_holders_for_limit to ConcurrencyLeaseStorage protocol by @zzstoatzz in https://github.com/PrefectHQ/prefect/pull/18970read_active_lease_ids by @zzstoatzz in https://github.com/PrefectHQ/prefect/pull/18973Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.19.dev3...3.4.19.dev4
One column per quarter.