docs/v3/release-notes/oss/version-3-2.mdx
Released on March 28, 2025
Stay tuned, our next release will include Python 3.13 support!
Enhancements ➕➕
prefect-client images to the release and pre-release builds by @chrisguidry in #17600[@classmethod](https://github.com/classmethod) and [@staticmethod](https://github.com/staticmethod) flows and tasks for Python 3.13 by @desertaxle in #17583Bug Fixes 🐞
typing-extensions lower bound by @zzstoatzz in #17581prefect.yaml steps by @zzstoatzz in #17607mark_flow_run_as_cancelled in worker still gets error by @lelouvincx in #17629Development & Tidiness 🧹
prefect-client-only image by @chrisguidry in #17596prefect-client by @chrisguidry in #17608pytz in the prefect-client dependencies by @chrisguidry in #17595Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.14...3.2.15
Released on March 21, 2025
Enhancements ➕➕
PREFECT_TASKS_DEFAULT_NO_CACHE to not cache by default by @cicdw in #17488prefect-docker's DockerRegistryCredentials as accepted type for ACI job configuration's image_registry by @kevingrismore in #17543Bug Fixes 🐞
NullFilesystem for transaction metadata storage by @zzstoatzz in #17541_resolve_path returning None by @cicdw in #17551Development & Tidiness 🧹
pyright check passing for prefect.runner submodules by @desertaxle in #17502Field examples kwargs for gcp and databricks by @zzstoatzz in #17526Documentation 📓
Experimental
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.13...3.2.14
Released on March 14, 2025
Enhancements ➕➕
Bug Fixes 🐞
PREFECT_CLOUD_ENABLE_ORCHESTRATION_TELEMETRY by @jeanluciano in #17417disable_run_logger context manager by @desertaxle in #17443serve deployment name truncation by @zzstoatzz in #17447prefect.yaml template is included in built package by @desertaxle in #17472create_api_app to fix errors when using server-side orchestration client by @desertaxle in #17474Development & Tidiness 🧹
run_task by @zzstoatzz in #17448Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.12...3.2.13
Released on March 10, 2025
This release contains a couple bug fixes (e.g. https://github.com/PrefectHQ/prefect/issues/17409, https://github.com/PrefectHQ/prefect/issues/17431, https://github.com/PrefectHQ/prefect/issues/17434) and adds a new freeze annotation to make certain deployment parameters read-only in the UI when creating a new flow run (see #17374 for an example).
Enhancements ➕➕
freeze annotation by @zzstoatzz in #17374Bug Fixes 🐞
await of RunnerDeployment by @zzstoatzz in #17436[project.optional-dependencies] by @desertaxle in #17435Documentation 📓
Development ⚙️
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.11...3.2.12
Released on March 05, 2025
This release includes a bug fix where import from prefect.deployments.flow_runs were failing without the otel extra installed.
Bug Fixes 🐞
prefect.deployments.flow_runs by @desertaxle in #17392Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.10...3.2.11
Released on March 05, 2025
Enhancements ➕➕
prefect flow-run execute by @desertaxle in #17352Bug Fixes 🐞
git_clone where branch name has forward-slash by @zzstoatzz in #17359RunnerDeployment with a work_pool_name given to serve by @zzstoatzz in #17349Runner exception handling by @desertaxle in #17376run_deployment by @fatih-acar in #16812Integrations & Dependencies 🤝
prefect-kubernetes's dependency on prefect by @zzstoatzz in #17347Development & Tidiness 🧹
ruff settings in pyproject.toml by @desertaxle in #17382Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.9...3.2.10
Released on February 28, 2025
This release contains a fix for bug a where the default Runner limit would propagate to the ProcessWorker. The fix restores the default behavior for the ProcessWorker before the 3.2.8 release.
Bug Fixes 🐞
Runner used by ProcessWorker by @desertaxle in #17325uv if Python interface isn't available by @desertaxle in #17320Integrations & Dependencies 🤝
Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.8...3.2.9
Released on February 28, 2025
Enhancements ➕➕
Bug Fixes 🐞
ProcessWorker to delegate flow run execution to a Runner by @desertaxle in #17295prefect cloud login and prefect cloud workspace set by @zzstoatzz in #17296profile use switching by @zzstoatzz in #17300Integrations & Dependencies 🤝
Development & Tidiness 🧹
KubernetesClusterConfig at the top level of prefect-kubernetes by @desertaxle in #17268Documentation 📓
Experimental
KuberenetesWorker.submit for ad-hoc submission to a Kubernetes work pool by @desertaxle in #17218@kubernetes decorator by @desertaxle in #17248bundles.types file in prefect-aws by @zzstoatzz in #17241PrefectFuture implementation for flow runs by @desertaxle in #17234Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.7...3.2.8
Released on February 21, 2025
This release fixes a bug where the EventPersister was not running by default.
Enhancements ➕➕
cache_ok flag to true for UUIDList by @cicdw in #17232Bug Fixes 🐞
cancelled_flow_query by @zzstoatzz in #17095logging.yaml by @zzstoatzz in #17162PREFECT_SERVER_API_BASE_PATH setting by @cicdw in #16967EventPersister in discovery of background services by @chrisguidry in #17240Integrations & Dependencies 🤝
prefect-aws bundle steps by @zzstoatzz in #17201Development & Tidiness 🧹
types-dateparser to dev deps by @sobolevn in #17212just instead of make command runner and use uv by @zzstoatzz in #17149Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.6...3.2.7
Released on February 19, 2025
This release includes a fix for https://github.com/PrefectHQ/prefect/issues/17197, where poetry users encountered errors when installing prefect due to a self-referential dependency.
Bug Fixes 🐞
client extras and moves them to top-level dependencies by @desertaxle in #17202Integrations & Dependencies 🤝
Documentation 📓
Experimental 🧪
Runner by @desertaxle in #17192Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.5...3.2.6
Released on February 19, 2025
This release includes a fix for https://github.com/PrefectHQ/prefect/issues/17182, where pull steps were not correctly updated upon changes to a given deployment.
Bug Fixes 🐞
Development & Tidiness 🧹
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.4...3.2.5
Released on February 18, 2025
fixes issue with 3.2.3
There was a packaging bug with 3.2.3 where the UI was not included in the published wheel due to project configuration changes, which this release resolves.
KubernetesWorker by @kevingrismore in #17174server/ui to wheel by @zzstoatzz in #17176Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.3...3.2.4
Released on February 18, 2025
Development & Tidiness 🧹
pyproject.toml by @zzstoatzz in #17116pendulum in tests/: part 1 by @zzstoatzz in #17106Documentation 📓
Uncategorized
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.2...3.2.3
Released on February 13, 2025
Notably, includes a fix for multiple schedules with the same interval and different parameters.
Bug Fixes 🐞
Integrations & Dependencies 🤝
prefect-snowflake - Bump snowflake dependency by @seanpwlms in #17098Development & Tidiness 🧹
pendulum in prefect.cli by @zzstoatzz in #17078prefect.client by @zzstoatzz in #17099prefect.concurrency by @zzstoatzz in #17102Documentation 📓
PrefectDbtRunner docs by @kevingrismore in #17055prefect-dbt prerelease install command with -U by @kevingrismore in #17088Uncategorized
flow_run_id in Abort case of engine by @peterbygrave in #17087pendulum use in prefect._internal by @zzstoatzz in #17072load_function_and_convert_to_flow by @jakekaplan in #17086pendulum usage to internal shim by @desertaxle in #17074pendulum usage in prefect.server.services by @desertaxle in #17100pendulum usage in prefect.server by @desertaxle in #17104Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.1...3.2.2
Released on February 10, 2025
Enhancements ➕➕
Bug Fixes 🐞
PREFECT_PROFILES_PATH from PREFECT_HOME by @zzstoatzz in #17070prefect deploy by @desertaxle in #17079Integrations & Dependencies 🤝
Development & Tidiness 🧹
npm version in Docker UI build by @desertaxle in #17064Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.2.0...3.2.1
Released on February 08, 2025
This release contains a lot! In particular, users can now specify parameters on a per-schedule basis. This is useful for flows with multiple schedules, for example:
from prefect import flow
from prefect.schedules import Cron
@flow
def send_email(to: str, message: str = "Stop goofing off!"):
print(f"Sending email to {to} with message: {message}")
send_email.serve(
name="my-flow",
schedules=[
Cron(
"0 8 * * *",
parameters={"to": "[email protected]"}
),
Cron(
"5 8 * * *",
parameters={
"to": "[email protected]",
"message": "Stop goofing off! You're assistant _to_ the regional manager!"
}
)
]
)
See the documentation for more details.
Enhancements ➕➕
PATCH /deployments/{id} endpoint for existing deployments by @desertaxle in #17050prefect.yaml by @desertaxle in #16963.serve and .deploy by @desertaxle in #16965Bug Fixes 🐞
create_markdown_artifact usage in prefect-dbt by @zzstoatzz in #16926host with prefect server start by @zzstoatzz in #16960wait warning to more specific circumstances by @cicdw in #16969docker work pool by @zzstoatzz in #170223.1.15 for prefect-dbt by @zzstoatzz in #17010to_state_create by @cicdw in #17033Integrations & Dependencies 🤝
ruff==0.9.2 and mypy==1.14.1 by @chrisguidry in #16916<2025,>=2021.1 to >=2021.1,<2026 by @dependabot in #16936PrefectDbtRunner by @kevingrismore in #16971Development & Tidiness 🧹
emit_event docstring by @zzstoatzz in #16918prefect-dask test suite by @desertaxle in #16920pendulum use in schedules.py by @zzstoatzz in #16943Documentation 📓
Services to the base class by @chrisguidry in #16913TASK_SOURCE behavior by @zzstoatzz in #16928/reference redirects by @znicholasbrown in #16980reference redirects by @jimid27 in #16993Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.1.15...3.2.0