3.4

​

3.4.11 - Heads up, the repo man is coming for your deployment concurrency slot

Released on July 31, 2025 Enhancements ➕➕

• Update deployment concurrency limits to use leasing by @desertaxle in #18567
• Update ad hoc installations to use uv if available by @desertaxle in #18618

Bug Fixes 🐞

• Allow automations to notify when the triggers service is disabled by @fatih-acar in #18577
• Truncate oversized log messages to prevent ValueError and improve flow debuggability by @nrnavaneet in #18550
• Fix async locking error by generating a unique holder for each transaction by @desertaxle in #18607

Integrations & Dependencies 🤝 prefect-azure

• Add PREFECT_API_AUTH_STRING to secure environment variables for ACI worker by @desertaxle in #18624

prefect-aws

• Add support for providing PREFECT_API_AUTH_STRING as a secret to ECS tasks by @desertaxle in #18620

prefect-dbt

• Handle dbt source types and source manifest references by @kevingrismore in #18570
• Omit compiled dbt code when it exceeds max asset description length by @kevingrismore in #18572
• Bump minimum prefect version for prefect-dbt by @desertaxle in #18623

prefect-gcp

• Add GCP secret support to CloudRunV2Worker for Prefect API key/auth string by @desertaxle in #18594
• Add GCP secret support to CloudRunWorker for Prefect API credentials by @desertaxle in #18608
• Improve performance of uploads to GCP bucket by @zzstoatzz in #18571

prefect-kubernetes

• Allow specifying the key for an existing Kubernetes worker API auth string secret by @mitchnielsen in #18578

Development & Tidiness 🧹

• Update @prefecthq/prefect-ui-library to version 3.13.2 by @marvin-robot in #18597

Documentation 📓

• Update API Reference for new mdxify version by @zzstoatzz in #18568
• Add --include-inheritance to SDK reference docs builds by @kevingrismore in #18529
• Add more states to docs by @rcash in #18573
• Fix docstrings and regenerate SDK docs by @kevingrismore in #18579
• Fix example rendering in CLI ref by @zzstoatzz in #18580
• Update concurrency limit examples by @kevingrismore in #18604
• Add detail and options to the GitHub Quickstart by @kevingrismore in #18621
• Fix broken links in docs by @bdalpe in #18609
• Fix styling of certain code blocks and links in docs by @markupboy in #18625

Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.10…3.4.11

---

​

3.4.10 - Lease and thank you

Released on July 22, 2025 Enhancements ➕➕

• Update async concurrency context manager to use leases by @desertaxle in #18522
• Update sync concurrency context manager to use leases by @desertaxle in #18535
• Track concurrency limit lease creation time and use it to calculate occupancy seconds by @desertaxle in #18551

Integrations & Dependencies 🤝

• Update @prefecthq/prefect-ui-library to version 3.13.1 by @marvin-robot in #18563
• Bump form-data from 4.0.0 to 4.0.4 in /ui by @dependabot[bot] in #18561

Documentation 📓

• Add note about PREFECT_API_KEY in ecs guide by @zzstoatzz in #18547

Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.9…3.4.10

---

​

3.4.9 - It’s the Lease We Can Do

Released on July 17, 2025 Enhancements ➕➕

• Add in-memory concurrency lease storage by @desertaxle in #18481
• Add repossessor service by @desertaxle in #18492
• Document an official Docker Compose setup by @Toshaksha in #18509
• Delete logs when deleting a flow or task run by @johnnyg in #18517
• Allow infrastructure bound flows to be dispatched to existing workers by @desertaxle in #18472
• Add endpoint for acquiring concurrency slots with a lease by @desertaxle in #18512
• Add concurrency lease renewal endpoint by @desertaxle in #18513
• Add endpoint to decrement concurrency limits with a lease by @desertaxle in #18515
• Support templated —flow-run-name values in prefect deployment run by @nrnavaneet in #18511

Bug Fixes 🐞

• Fix Block secret serialization for fields with Union type by @desertaxle in #18491
• Remove restricted characters from dbt asset keys by @kevingrismore in #18484
• Fix MinIOCredentials documentation to use correct boto3 parameter name by @zzstoatzz in #18493
• Add labels to scheduled runs by @cicdw in #18524
• Raise pydantic lower pin to 2.10.1 by @desertaxle in #18533
• ✨ fix(server): update Prefect server docs URL in startup message by @l-lumin in #18539

Development & Tidiness 🧹

• Add no-commit-to-branch hook to prevent accidental commits to main by @desertaxle in #18504
• Update @prefecthq/prefect-ui-library to version 3.13.0 by @marvin-robot in #18527
• Update dbt integration codeowners by @kevingrismore in #18483
• skip no-commit-to-branch check on merge to main by @zzstoatzz in #18505
• Enforce max asset description length by @jakekaplan in #18541

Documentation 📓

• Revert “Add —flow-run-name option to deployment run CLI with templating support” by @zzstoatzz in #18503
• Added support for setting flow run name in deployment CLI by @nrnavaneet in #18506
• Reintroduce the “Develop a custom worker” guide by @desertaxle in #18516
• expose new doc file in nav by @zzstoatzz in #18520
• a couple more edits to docker compose doc by @zzstoatzz in #18521
• Chore: update docs logo link from prefect.io => docs.prefect.io by @znicholasbrown in #18525
• add section on running work to completion by @zzstoatzz in #18537
• add db maintenance guide by @zzstoatzz in #18526

Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.8…3.4.9

---

​

3.4.8 - Objects in Mirror Are JSONer Than They Appear

Released on July 10, 2025 Enhancements ➕➕

• Add section on dynamic asset materialization by @cicdw in #18383
• Add —output and -o flags to all inspect commands, supporting ‘json’ by @cicdw in #18390
• add prefect automation create command by @zzstoatzz in #18452
• Add setting for configuring custom headers by @cicdw in #18444

Bug Fixes 🐞

• Fix UI URL generation for FlowRunResponse in Slack automations by @zzstoatzz in #18407
• Fix broken Google-indexed documentation URLs with redirects by @zzstoatzz in #18409
• Fix worker crash when flow file is missing during hook execution by @zzstoatzz in #18424
• clear pull_steps when no storage on deployment by @zzstoatzz in #18446
• Account for null pull steps in CLI by @cicdw in #18454
• Use UUID path converter in all places by @cicdw in #18455
• Fix visit_collection to properly handle shared references by @zzstoatzz in #18434

Integrations & Dependencies 🤝

• fail loudly if we can’t connect to custom dask cluster by @zzstoatzz in #18432
• Snowflake: Handle pool and service timeouts in SPCS worker by @bjorhn in #18403
• Fix dbt logging behavior, improve context handling by @kevingrismore in #18377
• Resolve dbt profiles and other improvements by @kevingrismore in #18410
• Allow Prefect API key to be provided to an ECS tasks via an AWS secret by @desertaxle in #18474

Development & Tidiness 🧹

• Update @prefecthq/prefect-design to version 2.15.2 by @marvin-robot in #18387
• Update @prefecthq/prefect-design to version 2.15.3 by @marvin-robot in #18418
• Update @prefecthq/prefect-design to version 2.15.4 by @marvin-robot in #18419
• Update @prefecthq/prefect-ui-library to version 3.12.17 by @marvin-robot in #18426
• Migrate integration tests from custom test runner to pytest by @desertaxle in #18450
• Deflake schedule statefulness test by @desertaxle in #18468
• Improve reliability of integration tests by @desertaxle in #18469
• Update test to connect to websocket with custom headers by @desertaxle in #18479
• update pins on core by @zzstoatzz in #18382

Documentation 📓

• Docs for dbt-core==0.7.1 by @kevingrismore in #18380
• begin “dependent settings” refactor by @zzstoatzz in #18029
• Fix api ref and open source links in new tab by @zzstoatzz in #18385
• Adds Worker healthcheck advanced guide by @cicdw in #18384
• Add section of examples on schedule CLI by @cicdw in #18386
• Add how to guide for running prefect server on windows by @cicdw in #18388
• Update Event trigger docs for match_related by @bdalpe in #18405
• Reformat all examples in docstrings by @cicdw in #18389
• Run api-ref generation to incorporate new examples syntax by @cicdw in #18406
• Update Slack footer link by @bdalpe in #18421
• add note about events in server metadata page by @zzstoatzz in #18459
• fix order of concept items by @zzstoatzz in #18460
• add How To Run Deployments doc by @zzstoatzz in #18464
• New quickstart by @kevingrismore in #18473

Uncategorized

• chore(deps): bump vue from 3.5.16 to 3.5.17 in /ui by @dependabot[bot] in #18345
• Update CODEOWNERS by @cicdw in #18391
• Update cloud block urls for CLI by @kevingrismore in #18423
• Enhance BitBucket Credentials Block: Support Special Characters in Username and Escape Git URL Credentials by @nrnavaneet in #18447
• Fix errors in ECS worker related to ad hoc submission by @desertaxle in #18438
• remove ujson from deps by @zzstoatzz in #18448
• Migrate LocalFileSystem from sync_compatible to async_dispatch by @zzstoatzz in #18413
• use correct key name for basic auth local storage by @zzstoatzz in #18457
• Fix failing unit tests by @desertaxle in #18463
• Include run count in state change events by @kevingrismore in #18466
• Update RetryFailedFlows orchestration policy to clear retry type on exhausted retries by @desertaxle in #18462
• Remove dependency on dbt_project.yml by @kevingrismore in #18465
• Rename extra_headers to additional_headers by @vyagubov in #18478

Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.7…3.4.8

---

​

3.4.7 - Stream a Little Stream of Logs

Released on June 26, 2025 Enhancements ➕➕

• Add not_any_ filter for DeploymentFilterId by @zzstoatzz in #18344
• Snowflake: Fixed error message when retrieving SPCS container status by @bjorhn in #18358
• Add —web flag to inspect runs from the command line by @zzstoatzz in #18370
• Add tags support to Automation objects by @chrisguidry in #18286
• Add tag filtering support for automations by @chrisguidry in #18288
• serialization performance improvements by @zzstoatzz in #18314
• Add client-side logs subscriber module by @chrisguidry in #18318
• Add pause_deployment and resume_deployment client methods by @zzstoatzz in #18336
• Track subflow results along with task results by @jakekaplan in #18338
• Add an axios middleware for intercepting errors by @znicholasbrown in #18365
• Materialize Prefect assets with dbt core by @kevingrismore in #18350

Bug Fixes 🐞

• fix TimeoutError in result_async when accessing results from delay by @zzstoatzz in #18280
• Fix for issue 18239 by @TWeatherston in #18284
• [prefect-aws] order env vars for task def equality by @zzstoatzz in #18309
• Fix serialization edge case in Prefect blocks by @zzstoatzz in #18363
• Fix asyncio loop issue when deploying with proxy by @zzstoatzz in #18374
• support assets for with_options by @jesse-c in #18353
• Fix subprocess cleanup in prefect_test_harness to prevent ResourceWarning by @zzstoatzz in #18376
• Fix throwing no key exception by @emmanuel-ferdman in #18281
• Drop task_run.state_id foreign key to prevent deadlocks by @zzstoatzz in #18302

Development & Tidiness 🧹

• bump lockfile and run pre-push hooks by @zzstoatzz in #18308
• remove fetch kwarg from docstring and overloads by @zzstoatzz in #18311
• fix 3.9 test for prefect-shell by @zzstoatzz in #18014
• run pre-push hooks by @zzstoatzz in #18330
• Update @prefecthq/prefect-ui-library to version 3.12.15 by @marvin-robot in #18348
• add api ref for python sdk by @zzstoatzz in #18334
• Update @prefecthq/prefect-ui-library to version 3.12.16 by @marvin-robot in #18366
• Update @prefecthq/prefect-design to version 2.15.1 by @marvin-robot in #18378
• make warning debug by @zzstoatzz in #18327
• omit nested venv from docker builds by @zzstoatzz in #18328
• Enforce asset key characters + length by @jakekaplan in #18379

Documentation 📓

• add docs on HA self-hosted setups by @zzstoatzz in #18279
• improve self-host guide name by @zzstoatzz in #18289
• Move security settings into their own doc by @cicdw in #18316
• Add /api/logs/out websocket endpoint for live log streaming by @chrisguidry in #18315
• Update contribution guide to require pre-push hooks by @zzstoatzz in #18332
• dont need separate command for pre-push by @zzstoatzz in #18351
• Update API refs to remove old style bracket links by @cicdw in #18355
• Remove brackets from example by @cicdw in #18360
• Remove more example brackets by @cicdw in #18361
• add some api-ref examples and avoid right hand nav pollution by @zzstoatzz in #18367
• Add AGENTS.md documentation files by @zzstoatzz in #18248
• improve agent guidance and remove redundant info by @zzstoatzz in #18321

Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.6…3.4.7

---

​

3.4.6 - Per My Last NOTIFY

Released on June 11, 2025 📰 Check out Prefect Assets! Bug Fixes 🐞

• use pg notify/listen for multi-server automation synchronization by @zzstoatzz in #18266
• Remove versions of pydantic that produce thread safety issues by @cicdw in #18250
• fix config validation for nested and constrained settings by @zzstoatzz in #18260
• add note about long migrations with big tables by @zzstoatzz in #18268
• Add automations prefix to validate route by @cicdw in #18277
• Fix nested materialization behavior by @jakekaplan in #18265

Development & Tidiness 🧹

• Update @prefecthq/prefect-design to version 2.15.0 by @marvin-robot in #18274
• Add tests for UI variable duplication enhancement by @vilhenad in #18245
• Replaced deprecated logic in SPCS worker by @bjorhn in #18105

Documentation 📓

• remove reference to “pull work pools” by @zzstoatzz in #18256
• add note on --no-prompt by @zzstoatzz in #18261
• Fix incorrect links to SDK by @bdalpe in #18262
• Remove v2 file from docs by @cicdw in #18267

Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.5…3.4.6

---

​

3.4.5 - Assets Have Been Materialized Internally

Released on June 07, 2025 To learn more, register for next week’s webinar here! New Features 💅

• Add Asset + [@materialize](https://github.com/materialize)ing tasks by @jakekaplan in #18230
• Emit asset.referenced events on materialization only by @jakekaplan in #18252
• Support emitting asset events for DaskTaskRunner by @jakekaplan in #18241
• Support emitting asset events for RayTaskRunner by @jakekaplan in #18242

Bug Fixes 🐞

• use kopf event for occurred in forwarded prefect events by @zzstoatzz in #18226
• Subclassing to set the max_range per sandox environment (#18083) by @steveh-101 in #18232
• Early return bucket path to avoid duplicated prefix in GCS bucket by @zzstoatzz in #18237
• Attempt retries when task returns a failed state by @bunchesofdonald in #18240
• log warning if volumes set via create kwargs by @zzstoatzz in #18233
• prefect-redis: fix min group id and deprecation warning by @zzstoatzz in #18215
• fix SendGrid behavior when modifying instance by @zzstoatzz in #18219
• fix async retry fn typing by @zzstoatzz in #18247

Development & Tidiness 🧹

• Update @prefecthq/prefect-design to version 2.14.26 by @marvin-robot in #18204
• lower bound pin uv by @zzstoatzz in #18216
• Update @prefecthq/prefect-ui-library to version 3.12.14 by @marvin-robot in #18234
• run uv sync -U by @zzstoatzz in #18251
• fix test assertion by @zzstoatzz in #18236
• Adds missing increments for events client metrics by @chrisguidry in #18246

Documentation 📓

• Docs refactor by @cicdw in #18208
• fix dead links by @zzstoatzz in #18243
• fix dead link to zombie flow runs by @zzstoatzz in #18244
• fix link to downstream-upstream trigger with serve by @zzstoatzz in #18249

Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.4…3.4.5

---

​

3.4.4 - No Cache in the Banana Stand

Released on May 29, 2025 Enhancements ✨

• Setting to disable cache globally by @zzstoatzz in #18195
• Add redis publisher/consumer settings by @zzstoatzz in #18160

Bug Fixes 🐞

• Enables CSRF protection support on internal server requests by @chrisguidry in #18157
• Corrects an infinite loop in the CancellationCleanup service by @chrisguidry in #18158
• Handle None metadata in prefect version by @zzstoatzz in #18190
• Merge duplicate extra_hosts kwarg by @zzstoatzz in #18192
• fix fractional value handling in retry delay policy by @zzstoatzz in #18200
• multi-server setup fixes pt1 by @zzstoatzz in #18149

Development & Tidiness 🧹

• Update @prefecthq/prefect-ui-library to version 3.12.13 by @marvin-robot in #18202
• Bump some upper bounds by @zzstoatzz in #18175
• Remove reimplementation of from_template_and_values from ECS worker by @kevingrismore in #18201
• chore(deps): bump vue from 3.5.13 to 3.5.14 in /ui by @dependabot in #18101

Documentation 📓

• Add thread local context note by @zzstoatzz in #18147
• Add prefect managed compute usage to the docs by @jakekaplan in #18194

Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.3…3.4.4

---

​

3.4.3 - You Return NotImplemented, I Return False. We Are Not The Same

Released on May 22, 2025 Enhancements ➕➕

• add settings to configure asyncpg mtls by @29x10 in #18097

Bug Fixes 🐞

• fix AttributeError during equality check after args/kwargs deletion by @zzstoatzz in #18110
• handle list value envvar overrides for logging by @levzem in #18062

Development & Tidiness 🧹

• minor log cleanup by @zzstoatzz in #18127

Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.2…3.4.3

---

​

3.4.2 - Stay classy

Released on May 19, 2025 Enhancements ➕➕

• Support serving [@classmethod](https://github.com/classmethod) and [@staticmethod](https://github.com/staticmethod) flows by @vyagubov in #18065

Bug Fixes 🐞

• Make RedisLockManager picklable for Ray/Dask compatibility by @zzstoatzz in #18018
• Fix parsing for PREFECT_TASK_DEFAULT_RETRY_DELAY_SECONDS by @zzstoatzz in #18043
• Add boolean flag execute_commit for SELECT statements by @DSauterIntersport in #18095
• Fix bug where the runner would try to cancel a flow run that was not running by @desertaxle in #18108
• Update call method to handle string payloads by @qabilityp in #18058

Integrations & Dependencies 🤝

• Update jsonschema lower bound to 4.18+ by @zzstoatzz in #18036
• Vendor uuid7 implementation by @desertaxle in #18046

prefect-kubernetes

• Disable kopf scanning for prefect-kubernetes observer by @desertaxle in #18013

prefect-docker

• Add option to persist auto-generated Dockerfile by @AliLordLoss in #17866

prefect-shell

• Improve typing in prefect-shell by @zzstoatzz in #18002

Development & Tidiness 🧹

• Move generation hooks to pre-push by @desertaxle in #18010
• Task worker hygiene by @zzstoatzz in #18016
• Fix readme link by @zzstoatzz in #17999
• Run prefect-client smoke tests against local server by @desertaxle in #18067
• Fix error in setup for client compatibility tests by @desertaxle in #18100

Documentation 📓

• Adds Google site verification tag to our docs by @cicdw in #18031

Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.1…3.4.2

---

​

3.4.1 - Zen and the Art of Kubernetes Job Submission

Released on May 08, 2025 This release also ships with version 0.6.0 of prefect-kubernetes, featuring a revamped Kubernetes worker. The updated worker is more stateless, providing improved resiliency, enhanced event emission, and better crash detection capabilities. See #18004 for more details. Enhancements ➕➕

• Support staticmethod and classmethod flow entrypoints by @vyagubov in #17976
• Adds support for ANDed related resources in queries and triggers by @chrisguidry in #18003
• Refactor Runner to receive cancellation signals via websocket by @desertaxle in #17973
• Parse docker image strings with digests by @kevingrismore in #17987
• Add DB index for automation event followers by @zzstoatzz in #17981
• Update variable name validator to allow hyphens by @znicholasbrown in #17995
• Allow flow.submit to be non-blocking for some infrastructure types by @desertaxle in #17992
• Uses UUIDv7 for the IDs of time-oriented objects by @chrisguidry in #18008

Bug Fixes 🐞

• Use correct secret in task worker websocket subscription by @zzstoatzz in #17975
• Update Runner to use a long-lived EventsClient by @desertaxle in #17986
• Catch FileNotFoundError in find_uv_bin by @zzstoatzz in #17993
• Coalesce flow run start times with expected start times by @znicholasbrown in #17997
• Fix generated work pool storage config for GCS by @desertaxle in #18000
• Fix run scatterplot pagination by @znicholasbrown in #18009

Integrations & Dependencies 🤝

• Refactor Kubernetes worker to reduce statefulness by @desertaxle in #18004
• Fix regex for Snowflake private keys by @zzstoatzz in #17985
• Bump vue-tsc from 2.2.8 to 2.2.10 in /ui by @dependabot in #17923

Development & Tidiness 🧹

• Add test covering .with_options when used with a classmethod flow by @vilhenad in #17647
• Consolidate validation on self-validating types by @zzstoatzz in #17994

Documentation 📓

• Add parameter form documentation by @zzstoatzz in #17972
• Add deployment versioning documentation by @kevingrismore in #17974

Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.4.0…3.4.1

---

​

3.4.0 - Pour one out for the flow run notification service

Released on May 02, 2025 This release removes the deprecated flow run notifications feature. Existing notification policies will be automatically migrated to automations when the server starts after upgrading. Notifications will continue to work as expected—no user action is required. Enhancements ➕➕

• Allow providing a commit sha to the git_clone pull step by @kevingrismore in #17933
• Add default result storage for work pools by @desertaxle in #17953
• Remove flow run notifications by @desertaxle in #17939
• Add version info inference to flow.deploy() by @kevingrismore in #17966

Bug Fixes 🐞

• handle heartbeat event in wait_for_flow_run by @zzstoatzz in #17930
• add parameters validator to DeploymentCreateFlowRun by @zzstoatzz in #17938
• Fix links to Specify flow parameters section by @bkkkk in #17942
• fix dead-lock between ConcurrentTaskRunner, wait_for, and tag concurrency limits by @zzstoatzz in #17943
• Remove future garbage collection warning by @cicdw in #17954
• fix: Specify project during Cloud Run provision by @danfairs in #17965
• Remove extra="forbid" config on WorkPoolStorageConfiguration by @desertaxle in #17960

Development & Tidiness 🧹

• Update uv.lock and fix ECS provisioner test errors by @desertaxle in #17928
• Remove unnecessary walrus by @zzstoatzz in #17957
• Add logfire dependency group for performance exploration by @zzstoatzz in #17860
• Bump astral-sh/setup-uv from 5 to 6 by @dependabot in #17906
• Update whenever requirement from <0.8.0,>=0.7.3 to >=0.7.3,<0.9.0 by @dependabot in #17962
• Run integration tests against prefect-client by @desertaxle in #17967
• Update packaging requirement from <24.3,>=21.3 to >=21.3,<25.1 by @dependabot in #17871
• Downgrade log to debug level by @cicdw in #17970

Documentation 📓

• Add vcs version types for Gitlab, Bitbucket, and Azure Devops by @kevingrismore in #17915
• Add documentation for Prefect Cloud GitHub app by @jakekaplan in #17911

Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.3.7…3.4.0

---