# Prefect changelog

> Turns Python functions into observable, retryable workflow runs.

- Vendor: Prefect
- Category: Developer Tools
- Official site: https://www.prefect.io
- Tracked by: What's New (https://whatsnew.fyi/product/prefect)
- Harvested from: GitHub (PrefectHQ/prefect)
- Entries below: 10 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## Releases

### 3.8.2 — 3.8.2 - Array we there yet?

- Date: 2026-08-07
- Version: 3.8.2
- Original notes: https://github.com/PrefectHQ/prefect/releases/tag/3.8.2
- Permalink: https://whatsnew.fyi/product/prefect/releases/3.8.2

- **added** — Add removable chips for multi-select enum array fields
- **added** — Send a Prefect User-Agent on WebSocket handshakes
- **added** — Virtualize the timezone select option list
- **fixed** — Show all timezones in the timezone select
- **fixed** — Propagate array item edits and link deployments from the flow page
- **fixed** — Preserve an empty array when clearing list parameter selections
- **fixed** — Open the date picker calendar on the selected date's month
- **fixed** — Normalize settings paths for cross-OS context transport
- **fixed** — Raise ValueError for negative timeouts in PrefectFutureList.result, as_completed, and wait
- **fixed** — Fix a tooltip hiding behind a chart row
- **fixed** — Release concurrency leases granted to callers that were cancelled mid-acquire
- **fixed** — Keep setuptools in conda Docker images

**Enhancements ➕➕**

* Add removable chips for multi-select enum array fields by [@vyagubov](https://github.com/vyagubov) in [#22738](https://github.com/PrefectHQ/prefect/pull/22738)
* Send a Prefect `User-Agent` on WebSocket handshakes by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22706](https://github.com/PrefectHQ/prefect/pull/22706)
* Virtualize the timezone select option list by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22740](https://github.com/PrefectHQ/prefect/pull/22740)

**Bug Fixes 🐞**

* Show all timezones in the timezone select by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22686](https://github.com/PrefectHQ/prefect/pull/22686)
* Propagate array item edits and link deployments from the flow page by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22726](https://github.com/PrefectHQ/prefect/pull/22726)
* Preserve an empty array when clearing list parameter selections by [@vyagubov](https://github.com/vyagubov) in [#22737](https://github.com/PrefectHQ/prefect/pull/22737)
* Open the date picker calendar on the selected date's month by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22699](https://github.com/PrefectHQ/prefect/pull/22699)
* Normalize settings paths for cross-OS context transport by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22700](https://github.com/PrefectHQ/prefect/pull/22700)
* Raise `ValueError` for negative timeouts in `PrefectFutureList.result`, `as_completed`, and `wait` by [@kingsley-123](https://github.com/kingsley-123) in [#22692](https://github.com/PrefectHQ/prefect/pull/22692)
* Fix a tooltip hiding behind a chart row by [@uinstinct](https://github.com/uinstinct) in [#22707](https://github.com/PrefectHQ/prefect/pull/22707)
* Release concurrency leases granted to callers that were cancelled mid-acquire by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22621](https://github.com/PrefectHQ/prefect/pull/22621)
* Keep `setuptools` in conda Docker images by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22743](https://github.com/PrefectHQ/prefect/pull/22743)

**Development & Tidiness 🧹**

* Migrate to Renovate and retire Dependabot by [@jamiezieziula](https://github.com/jamiezieziula) in [#22719](https://github.com/PrefectHQ/prefect/pull/22719)

**Documentation 📓**

* Document how `follows` establishes event ordering for automation triggers by [@chrisguidry](https://github.com/chrisguidry) in [#22710](https://github.com/PrefectHQ/prefect/pull/22710)
* Correct event trigger examples to match actual matching semantics by [@bunchesofdonald](https://github.com/bunchesofdonald) in [#22690](https://github.com/PrefectHQ/prefect/pull/22690)
* Fix incorrect examples in the global concurrency limits docs by [@uinstinct](https://github.com/uinstinct) in [#22724](https://github.com/PrefectHQ/prefect/pull/22724)
* Fix text not visible in an image by [@uinstinct](https://github.com/uinstinct) in [#22661](https://github.com/PrefectHQ/prefect/pull/22661)
* Fix docstring `Args` entries that name a parameter the function does not take by [@darkdi](https://github.com/darkdi) in [#22733](https://github.com/PrefectHQ/prefect/pull/22733)
* List 3.7 and 3.8 release notes and link the Prefect Cloud changelog by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22702](https://github.com/PrefectHQ/prefect/pull/22702)

**Full Changelog**: https://github.com/PrefectHQ/prefect/compare/3.8.1...3.8.2

### 3.8.2.dev6 — 3.8.2.dev6: Nightly Development Release

- Date: 2026-08-07
- Version: 3.8.2.dev6
- Original notes: https://github.com/PrefectHQ/prefect/releases/tag/3.8.2.dev6
- Permalink: https://whatsnew.fyi/product/prefect/releases/3.8.2.dev6
- Labels: Pre-release

- **fixed** — Preserve empty array when clearing list parameter selections in UI v2
- **fixed** — Fix docstring Args entries that name a parameter the function does not take

<!-- Release notes generated using configuration in .github/release.yml at main -->

##### What's Changed
###### Bug Fixes 🐞
* fix(ui-v2): preserve empty array when clearing list parameter selections by @vyagubov in https://github.com/PrefectHQ/prefect/pull/22737
###### Uncategorized
* Fix docstring Args entries that name a parameter the function does not take by @darkdi in https://github.com/PrefectHQ/prefect/pull/22733

##### New Contributors
* @darkdi made their first contribution in https://github.com/PrefectHQ/prefect/pull/22733

**Full Changelog**: https://github.com/PrefectHQ/prefect/compare/3.8.2.dev5...3.8.2.dev6

### 3.8.2.dev5 — 3.8.2.dev5: Nightly Development Release

- Date: 2026-08-06
- Version: 3.8.2.dev5
- Original notes: https://github.com/PrefectHQ/prefect/releases/tag/3.8.2.dev5
- Permalink: https://whatsnew.fyi/product/prefect/releases/3.8.2.dev5
- Labels: Pre-release

- **fixed** — Don't treat a missing Redis stream as a connection error when trimming
- **fixed** — Crash flow runs when a Vertex AI job fails before the container starts
- **fixed** — Propagate array item edits and link deployments from flow page in UI
- **fixed** — Suppress CloudFormation validation warnings in ECS worker CDK synthesis
- **changed** — Migrate to Renovate and retire Dependabot

<!-- Release notes generated using configuration in .github/release.yml at main -->

##### What's Changed
###### Bug Fixes 🐞
* Don't treat a missing Redis stream as a connection error when trimming by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22722
* Crash flow runs when a Vertex AI job fails before the container starts by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22728
* fix(ui-v2): propagate array item edits and link deployments from flow page by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22726
###### Documentation 📓
* fix(prefect-aws): suppress CloudFormation validation warnings in ECS worker CDK synthesis by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22715
* fix incorrect examples in global-concurrency-limits doc by @uinstinct in https://github.com/PrefectHQ/prefect/pull/22724
###### Uncategorized
* feat(renovate): migrate to Renovate, retire Dependabot by @jamiezieziula in https://github.com/PrefectHQ/prefect/pull/22719


**Full Changelog**: https://github.com/PrefectHQ/prefect/compare/3.8.2.dev4...3.8.2.dev5

### 3.8.2.dev4 — 3.8.2.dev4: Nightly Development Release

- Date: 2026-08-05
- Version: 3.8.2.dev4
- Original notes: https://github.com/PrefectHQ/prefect/releases/tag/3.8.2.dev4
- Permalink: https://whatsnew.fyi/product/prefect/releases/3.8.2.dev4
- Labels: Pre-release

- **fixed** — Document how `follows` establishes event ordering for automation triggers
- **changed** — Send Prefect User-Agent on WebSocket handshakes
- **fixed** — Fix tooltip hiding behind chart row

<!-- Release notes generated using configuration in .github/release.yml at main -->

##### What's Changed
###### Bug Fixes 🐞
* Document how `follows` establishes event ordering for automation triggers by @chrisguidry in https://github.com/PrefectHQ/prefect/pull/22710
###### Development & Tidiness 🧹
* chore(deps): bump github/codeql-action from 4 to 4.37.4 by @dependabot[bot] in https://github.com/PrefectHQ/prefect/pull/22703
###### Documentation 📓
* docs: Add release notes for `prefect-kubernetes==0.7.12`, `prefect-redis==0.2.14`, `prefect-aws==0.7.11`, and `prefect-slack==0.4.0` by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22709
* docs: List 3.7 and 3.8 release notes and link Prefect Cloud changelog by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22702
###### Uncategorized
* Send Prefect User-Agent on WebSocket handshakes by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22706
* fix tooltip hiding behind chart row by @uinstinct in https://github.com/PrefectHQ/prefect/pull/22707


**Full Changelog**: https://github.com/PrefectHQ/prefect/compare/3.8.2.dev3...3.8.2.dev4

### 3.8.2.dev3 — 3.8.2.dev3: Nightly Development Release

- Date: 2026-08-04
- Version: 3.8.2.dev3
- Original notes: https://github.com/PrefectHQ/prefect/releases/tag/3.8.2.dev3
- Permalink: https://whatsnew.fyi/product/prefect/releases/3.8.2.dev3
- Labels: Pre-release

- **fixed** — Show all timezones in the ui-v2 timezone select
- **fixed** — Open date picker calendar on the selected date's month in ui-v2
- **fixed** — Normalize settings paths for cross-OS context transport
- **fixed** — Raise ValueError for negative timeout in PrefectFutureList.result, as_completed, and wait

<!-- Release notes generated using configuration in .github/release.yml at main -->

##### What's Changed
###### Bug Fixes 🐞
* Show all timezones in the ui-v2 timezone select by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22686
###### Documentation 📓
* fix text not visible in image by @uinstinct in https://github.com/PrefectHQ/prefect/pull/22661
###### Uncategorized
* fix(ui-v2): open date picker calendar on the selected date's month by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22699
* fix(context): normalize settings paths for cross-OS context transport by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22700
* fix: raise ValueError for negative timeout in PrefectFutureList.result, as_completed, and wait by @kingsley-123 in https://github.com/PrefectHQ/prefect/pull/22692


**Full Changelog**: https://github.com/PrefectHQ/prefect/compare/3.8.2.dev2...3.8.2.dev3

### 3.8.2.dev2 — 3.8.2.dev2: Nightly Development Release

- Date: 2026-08-03
- Version: 3.8.2.dev2
- Original notes: https://github.com/PrefectHQ/prefect/releases/tag/3.8.2.dev2
- Permalink: https://whatsnew.fyi/product/prefect/releases/3.8.2.dev2
- Labels: Pre-release

- **changed** — Bump docker/login-action from 4.5.2 to 4.6.0

<!-- Release notes generated using configuration in .github/release.yml at main -->

##### What's Changed
###### Development & Tidiness 🧹
* chore(deps): bump docker/login-action from 4.5.2 to 4.6.0 by @dependabot[bot] in https://github.com/PrefectHQ/prefect/pull/22697


**Full Changelog**: https://github.com/PrefectHQ/prefect/compare/3.8.2.dev1...3.8.2.dev2

### 3.8.2.dev1 — 3.8.2.dev1: Nightly Development Release

- Date: 2026-08-01
- Version: 3.8.2.dev1
- Original notes: https://github.com/PrefectHQ/prefect/releases/tag/3.8.2.dev1
- Permalink: https://whatsnew.fyi/product/prefect/releases/3.8.2.dev1
- Labels: Pre-release

- **changed** — Correct event trigger examples to match actual matching semantics

<!-- Release notes generated using configuration in .github/release.yml at main -->

##### What's Changed
###### Development & Tidiness 🧹
* chore(deps): bump docker/login-action from 4 to 4.5.2 by @dependabot[bot] in https://github.com/PrefectHQ/prefect/pull/22688
###### Documentation 📓
* docs: Correct event trigger examples to match actual matching semantics by @bunchesofdonald in https://github.com/PrefectHQ/prefect/pull/22690


**Full Changelog**: https://github.com/PrefectHQ/prefect/compare/3.8.1...3.8.2.dev1

### 3.8.1 — 3.8.1 - To relinquish, perchance to retry

- Date: 2026-07-30
- Version: 3.8.1
- Original notes: https://github.com/PrefectHQ/prefect/releases/tag/3.8.1
- Permalink: https://whatsnew.fyi/product/prefect/releases/3.8.1

- **added** — Show tooltips for flow run state tabs in the V2 UI
- **fixed** — Make ConcurrencyContext exit cleanup best-effort
- **fixed** — Keep worker startup alive when the Prefect API is unreachable
- **fixed** — Make PrefectFutureList.result timeout message reachable
- **fixed** — Render ANSI color escape codes in flow run logs in the V2 UI
- **fixed** — Confirm the exact suspension transition reported by a suspension event
- **fixed** — Allow any float precision on schema number inputs in the V2 UI
- **fixed** — Reject unknown fields for FlowRunFilter and its nested criteria
- **fixed** — Relinquish evicted flow runs to infrastructure retry
- **fixed** — Fix saved block parameters in deployments
- **fixed** — Preserve subprocesses after output stream errors
- **fixed** — Clear stale expiration entries when a repossessed lease is missing

**Enhancements ➕➕**

* Show tooltips for flow run state tabs in the V2 UI by [@uinstinct](https://github.com/uinstinct) in [#22617](https://github.com/PrefectHQ/prefect/pull/22617)

**Bug Fixes 🐞**

* Make `ConcurrencyContext` exit cleanup best-effort by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22619](https://github.com/PrefectHQ/prefect/pull/22619)
* Keep worker startup alive when the Prefect API is unreachable by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22640](https://github.com/PrefectHQ/prefect/pull/22640)
* Make `PrefectFutureList.result` timeout message reachable by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22634](https://github.com/PrefectHQ/prefect/pull/22634)
* Render ANSI color escape codes in flow run logs in the V2 UI by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22653](https://github.com/PrefectHQ/prefect/pull/22653)
* Confirm the exact suspension transition reported by a suspension event by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22649](https://github.com/PrefectHQ/prefect/pull/22649)
* Allow any float precision on schema number inputs in the V2 UI by [@AJ-ing](https://github.com/AJ-ing) in [#22643](https://github.com/PrefectHQ/prefect/pull/22643)
* Reject unknown fields for `FlowRunFilter` and its nested criteria by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22659](https://github.com/PrefectHQ/prefect/pull/22659)
* Relinquish evicted flow runs to infrastructure retry by [@chuqCTC](https://github.com/chuqCTC) in [#22622](https://github.com/PrefectHQ/prefect/pull/22622)
* Fix saved block parameters in deployments by [@desertaxle](https://github.com/desertaxle) in [#22568](https://github.com/PrefectHQ/prefect/pull/22568)
* Preserve subprocesses after output stream errors by [@desertaxle](https://github.com/desertaxle) in [#22573](https://github.com/PrefectHQ/prefect/pull/22573)
* Clear stale expiration entries when a repossessed lease is missing by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22657](https://github.com/PrefectHQ/prefect/pull/22657)

**Development & Tidiness 🧹**

* Fix codespell error on unit test `TEST_BLOCK_CODE_BAD_SYNTAX` on Windows by [@g-ringeisen](https://github.com/g-ringeisen) in [#22642](https://github.com/PrefectHQ/prefect/pull/22642)
* Drop unused global `mintlify-scrape` install from static analysis by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22677](https://github.com/PrefectHQ/prefect/pull/22677)

**Documentation 📓**

* Add missing line break after imports in documentation examples by [@uinstinct](https://github.com/uinstinct) in [#22627](https://github.com/PrefectHQ/prefect/pull/22627)
* Document `Submitting` and `InfrastructurePending` states by [@devin-ai-integration](https://github.com/devin-ai-integration)[bot] in [#22660](https://github.com/PrefectHQ/prefect/pull/22660)
* Fix flows documentation link to the getting started page by [@uinstinct](https://github.com/uinstinct) in [#22648](https://github.com/PrefectHQ/prefect/pull/22648)

**Full Changelog**: https://github.com/PrefectHQ/prefect/compare/3.8.0...3.8.1

### 3.8.1.dev5 — 3.8.1.dev5: Nightly Development Release

- Date: 2026-07-30
- Version: 3.8.1.dev5
- Original notes: https://github.com/PrefectHQ/prefect/releases/tag/3.8.1.dev5
- Permalink: https://whatsnew.fyi/product/prefect/releases/3.8.1.dev5
- Labels: Pre-release

- **fixed** — Confirm the exact suspension transition reported by a suspension event
- **fixed** — Fix codspell error on unit test TEST_BLOCK_CODE_BAD_SYNTAX on Windows
- **changed** — Clear stale expiration entries when a repossessed lease is missing
- **changed** — Reject unknown fields for FlowRunFilter and its nested criteria

<!-- Release notes generated using configuration in .github/release.yml at main -->

##### What's Changed
###### Bug Fixes 🐞
* Confirm the exact suspension transition reported by a suspension event by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22649
* Fix codspell error on unit test TEST_BLOCK_CODE_BAD_SYNTAX on Windows by @g-ringeisen in https://github.com/PrefectHQ/prefect/pull/22642
###### Development & Tidiness 🧹
* chore(deps): bump actions/stale from 10 to 11 by @dependabot[bot] in https://github.com/PrefectHQ/prefect/pull/22656
* Clear stale expiration entries when a repossessed lease is missing by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22657
###### Documentation 📓
* docs: document Submitting and InfrastructurePending states by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22660
###### Uncategorized
* Reject unknown fields for FlowRunFilter and its nested criteria by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22659

##### New Contributors
* @g-ringeisen made their first contribution in https://github.com/PrefectHQ/prefect/pull/22642

**Full Changelog**: https://github.com/PrefectHQ/prefect/compare/3.8.1.dev4...3.8.1.dev5

### 3.8.1.dev4 — 3.8.1.dev4: Nightly Development Release

- Date: 2026-07-29
- Version: 3.8.1.dev4
- Original notes: https://github.com/PrefectHQ/prefect/releases/tag/3.8.1.dev4
- Permalink: https://whatsnew.fyi/product/prefect/releases/3.8.1.dev4
- Labels: Pre-release

- **fixed** — Make PrefectFutureList.result timeout message reachable
- **fixed** — Render ANSI color escape codes in flow run logs
- **fixed** — Scope pull_from_s3 listing to the requested folder

<!-- Release notes generated using configuration in .github/release.yml at main -->

##### What's Changed
###### Bug Fixes 🐞
* fix(futures): make PrefectFutureList.result timeout message reachable by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22634
* fix(ui-v2): render ANSI color escape codes in flow run logs by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22653
###### Documentation 📓
* docs: add missing line break after imports by @uinstinct in https://github.com/PrefectHQ/prefect/pull/22627
###### Uncategorized
* fix(prefect-aws): scope pull_from_s3 listing to the requested folder by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/22647
* docs: fix flows doclink linking to get started page by @uinstinct in https://github.com/PrefectHQ/prefect/pull/22648


**Full Changelog**: https://github.com/PrefectHQ/prefect/compare/3.8.1.dev3...3.8.1.dev4