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 9 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.
Add Submitting and InfrastructurePending states and emit from BaseWorker by @desertaxle in #20964
New Features 🎉
Submitting and InfrastructurePending states and emit from BaseWorker by @desertaxle in #20964Enhancements ➕➕
end_time filter support for flow and task runs by @jellyfish0316 in #21013hmac.compare_digest for auth token comparisons by @bunchesofdonald in #21072flow_run_logger to accept a bare flow_run_id UUID by @devin-ai-integration[bot] in #21019None to 180s by @bunchesofdonald in #21058Bug Fixes 🐞
FlowRunCancellingObserver subscriber connection failure gracefully by @devin-ai-integration[bot] in #21039postgres_listener ssl query param causing CantChangeRuntimeParamError by @devin-ai-integration[bot] in #21040CANCEL_NEW strategy not cancelling late runs when limit is full by @devin-ai-integration[bot] in #21086endswith() health check path exemption by @bunchesofdonald in #21063Integrations & Dependencies 🤝
packaging upper bound from <25.1 to <26.1 by @purificant in #21015Development & Tidiness 🧹
test_two_subscriptions_get_all_events by handling None heartbeats by @devin-ai-integration[bot] in #21037test_cache_expiration_expires by using advance_time fixture by @devin-ai-integration[bot] in #21070Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.21...3.6.22
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.22.dev7...3.6.22.dev8
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
ssl query param causing CantChangeRuntimeParamError by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/21040test_cache_expiration_expires by using advance_time fixture by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/21070Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.22.dev6...3.6.22.dev7
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
FlowRunCancellingObserver subscriber connection failure gracefully by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/21039test_two_subscriptions_get_all_events by handling None heartbeats by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/21037flow_run_logger to accept a bare flow_run_id UUID by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/21019Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.22.dev5...3.6.22.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.6.22.dev4...3.6.22.dev5
<!-- 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.22.dev3...3.6.22.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.22.dev2...3.6.22.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.22.dev1...3.6.22.dev2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
prefect-dbt==0.7.20 by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20994Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.21...3.6.22.dev1
Add --output json support to flow ls command by @Br1an67 in #20907
Enhancements ➕➕
--output json support to flow ls command by @Br1an67 in #20907match_related type hints and add Python examples for DeploymentEventTrigger by @devin-ai-integration[bot] in #20902EventPersister to docket-based db_vacuum service by @tom21100227 in #20811--output json to task-run ls, work-pool ls, and concurrency-limit ls by @zzstoatzz in #20967--output json support to block inspect and block type inspect by @zzstoatzz in #20981--output json support to flow-run logs and task-run logs by @zzstoatzz in #20982--output json support to server services ls by @jellyfish0316 in #20983--output json support to cloud workspace and webhook commands by @zzstoatzz in #20984--output json support to work-queue ls and preview by @zzstoatzz in #20985--output json support to work-pool preview by @zzstoatzz in #20986--output json support to profile ls and config view by @zzstoatzz in #20987task_run(state_type, start_time) by @desertaxle in #20940task command by @zzstoatzz in #20925PREFECT_CLIENT_SERVER_VERSION_CHECK_ENABLED setting by @devin-ai-integration[bot] in #20973ProcessPoolTaskRunner.submit() by @devin-ai-integration[bot] in #20972Bug Fixes 🐞
postgres_listener to preserve Kerberos/GSSAPI and TLS connection params by @devin-ai-integration[bot] in #20890prefect deploy by @ashwanth0110 in #20874work-pool create sample code output by @Br1an67 in #20906PrefectHTTPStatusError message by @devin-ai-integration[bot] in #20938state_id references by @devin-ai-integration[bot] in #20941ResultStore._read/_aread by @devin-ai-integration[bot] in #20988Development & Tidiness 🧹
git_clone in pip_install_reqs test by @devin-ai-integration[bot] in #20949Documentation 📓
pull_with_block YAML example to Bitbucket integration docs by @toroleapinc in #20935PREFECT_API_URL env var in the self-hosted Docker Compose file by @Kiskadee-dev in #20897Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.20...3.6.21
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
EventPersister to docket-based db_vacuum service by @tom21100227 in https://github.com/PrefectHQ/prefect/pull/20811PrefectDbtOrchestrator by @desertaxle in https://github.com/PrefectHQ/prefect/pull/20958dbt deps step to DbtCoreExecutor by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20960plan() dry-run method to PrefectDbtOrchestrator by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20965Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.21.dev4...3.6.21.dev5
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
wait_for_completion by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20739Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.21.dev3...3.6.21.dev4
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
--output json support to flow ls command by @Br1an67 in https://github.com/PrefectHQ/prefect/pull/20907match_related type hints and add Python examples for DeploymentEventTrigger by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20902work-pool create sample code output by @Br1an67 in https://github.com/PrefectHQ/prefect/pull/20906prefect-dbt==0.7.19 by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20924Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.21.dev2...3.6.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.6.21.dev1...3.6.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.6.20...3.6.21.dev1
Migrate CLI from typer to cyclopts, remove toggle and delegation machinery by @zzstoatzz in #20821
Enhancements ➕➕
typer to cyclopts, remove toggle and delegation machinery by @zzstoatzz in #20821ProcessPoolTaskRunner subprocess events and logs through a single parent queue, improving per-task performance by ~28% in log-heavy workloads by @desertaxle in #20864ProcessPoolTaskRunner for custom event/log handling in the parent forwarder by @desertaxle in #20869Bug Fixes 🐞
None asset descriptions in events by @devin-ai-integration[bot] in #20840batch_size from 1000 to 200 to prevent query timeouts on Postgres by @zzstoatzz in #20857ProcessPoolTaskRunner when task completes before async event forwarding by @devin-ai-integration[bot] in #20876Development & Tidiness 🧹
_cyclopts/ to src/prefect/cli/, remove typer dependency by @zzstoatzz in #20838nvm from clobbering setup-node in pre-commit CI by @zzstoatzz in #20854Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.19...3.6.20
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
ProcessPoolTaskRunner by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20876Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.20.dev4...3.6.20.dev5
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
ProcessPoolTaskRunner subprocess events/logs through parent queue by @desertaxle in https://github.com/PrefectHQ/prefect/pull/20864Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.20.dev3...3.6.20.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.20.dev2...3.6.20.dev3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
_create_job by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20848None asset descriptions in events by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20840run_build() completes by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20839validate_for_orchestrator to PrefectDbtSettings by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20841_cyclopts/ to src/prefect/cli/, remove typer by @zzstoatzz in https://github.com/PrefectHQ/prefect/pull/20838Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.20.dev1...3.6.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.6.19...3.6.20.dev1
This release introduces an optional database vacuum service that periodically deletes old flow runs and orphaned resources (logs, artifacts, artifact
This release introduces an optional database vacuum service that periodically deletes old flow runs and orphaned resources (logs, artifacts, artifact collections) to keep your database lean. It's disabled by default — enable it with PREFECT_SERVER_SERVICES_DB_VACUUM_ENABLED=true. Once enabled, it runs hourly and removes terminal top-level flow runs older than 90 days. Both the retention period and frequency are configurable via PREFECT_SERVER_SERVICES_DB_VACUUM_RETENTION_PERIOD (in seconds, minimum 1 hour) and PREFECT_SERVER_SERVICES_DB_VACUUM_LOOP_SECONDS.
Enhancements ➕➕
prefect-gcp and prefect-azure by @devin-ai-integration[bot] in #20771Bug Fixes 🐞
CustomWebhookNotificationBlock by @devin-ai-integration[bot] in #20781Development & Tidiness 🧹
Documentation 📓
ImportString section to form-building guide by @zzstoatzz in #20768Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.18...3.6.19
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
prefect-gcp and prefect-azure by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20771Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.19.dev2...3.6.19.dev3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
CustomWebhookNotificationBlock by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20781prefect-dbt==0.7.18 and fix integration API ref generation by @desertaxle in https://github.com/PrefectHQ/prefect/pull/20789Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.19.dev1...3.6.19.dev2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
extra_cli_args passthrough to run_build() by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20770Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.18...3.6.19.dev1
Add opaque annotation to prevent recursive traversal of resolved task inputs by @devin-ai-integration[bot] in #20650
Enhancements ➕➕
opaque annotation to prevent recursive traversal of resolved task inputs by @devin-ai-integration[bot] in #20650PREFECT_WORKER_DEBUG_MODE for worker-only debug logging by @devin-ai-integration[bot] in #20653DateTimeDelta as interval option in IntervalSchedule by @devin-ai-integration[bot] in #20692Bug Fixes 🐞
TaskRunResponse by @vyagubov in #20664replaces handling by @chrisguidry in #20669uq_task_run__flow_run_id_task_key_dynamic_key constraint violation with multiple background workers by @devin-ai-integration[bot] in #20697Integrations & Dependencies 🤝
pydocket minimum version to 0.17.7 by @devin-ai-integration[bot] in #20731Development & Tidiness 🧹
server, worker, shell CLI commands to cyclopts by @zzstoatzz in #20603SessionStart hook to symlink AGENTS.md files to CLAUDE.md files by @desertaxle in #20667flow CLI command to cyclopts by @zzstoatzz in #20672flow-run CLI command to cyclopts by @zzstoatzz in #20673deployment CLI command to cyclopts by @zzstoatzz in #20721dashboard, task, sdk CLI commands to cyclopts by @zzstoatzz in #20723concurrency-limit, events, experimental CLI commands to cyclopts by @zzstoatzz in #20724variable, artifact, task-run, api CLI commands to cyclopts by @zzstoatzz in #20740dev, global-concurrency-limit CLI commands to cyclopts by @zzstoatzz in #20745block CLI command to cyclopts and add command aliases by @zzstoatzz in #20749work-queue CLI command to cyclopts by @zzstoatzz in #20763Documentation 📓
analytics module from API reference docs by @devin-ai-integration[bot] in #20722wait_for_input types generate a value field for programmatic resume by @desertaxle in #20741Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.17...3.6.18
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
wait_for_input types generate a value field for programmatic resume by @desertaxle in https://github.com/PrefectHQ/prefect/pull/20741PREFECT_WORKER_DEBUG_MODE for worker-only debug logging by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20653Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.18.dev5...3.6.18.dev6
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
DateTimeDelta as interval option in IntervalSchedule by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20692prefect-gcp API reference docs via mdxify by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20704analytics module from API reference docs by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20722replaces handling by @chrisguidry in https://github.com/PrefectHQ/prefect/pull/20669uq_task_run__flow_run_id_task_key_dynamic_key constraint violation with multiple background workers by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20697Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.18.dev4...3.6.18.dev5
<!-- 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.18.dev3...3.6.18.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.18.dev2...3.6.18.dev3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
SessionStart hook to symlink AGENTS.md files to CLAUDE.md files by @desertaxle in https://github.com/PrefectHQ/prefect/pull/20667opaque annotation to prevent recursive traversal of resolved task inputs by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20650Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.18.dev1...3.6.18.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.17...3.6.18.dev1
Remove deprecated GitHub Action reference by @seanpwlms in #20610
New Features 🎉
prefect server status command by @devin-ai-integration[bot] in #20619Enhancements ➕➕
PrefectFutureList.result() fail-fast using as_completed by @desertaxle in #20592replaces field for renaming schedule slugs by @desertaxle in #20460Bug Fixes 🐞
AwaitingRetry state by @vyagubov in #20318prefect transfer automations by @devin-ai-integration[bot] in #20639prefect deploy stripping {{ ctx.flow.* }} templates from job variables by @desertaxle in #20611ResumeFlowRun action to automation events by @lordsoffallen in #20604print_as_log so log formatters report the caller's location by @devin-ai-integration[bot] in #20618Development & Tidiness 🧹
test_error_handling_on_cache_policies by increasing random range by @devin-ai-integration[bot] in #20566test_docker_deploy: add retry logic for transient Docker registry errors by @devin-ai-integration[bot] in #20580config, profile, version to cyclopts (wave 1) by @zzstoatzz in #20585CycloptsCliRunner for in-process CLI testing by @zzstoatzz in #20609EXCLUDE_FROM_CLEAR_DB_AUTO_MARK by @devin-ai-integration[bot] in #20578UI_COMPONENTS_CONTENTS_PRS_RW with GITHUB_TOKEN in nightly release workflow by @jamiezieziula in #20602busy_timeout for better test concurrency by @devin-ai-integration[bot] in #20553Documentation 📓
caplog example by @rcash in #20570docs/AGENTS.md and write-docs skill for AI agent guidance by @desertaxle in #20606concurrency_options key in debouncing guide by @desertaxle in #20633schema.json paths by @devin-ai-integration[bot] in #20620Experimental 🧪
include_files support to @ecs decorator for bundling non-Python files by @desertaxle in #20551Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.16...3.6.17
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
print_as_log so log formatters report the caller's location by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20618prefect server status command by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20619prefect transfer automations by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20639Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.17.dev5...3.6.17.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.6.17.dev4...3.6.17.dev5
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
docs/AGENTS.md and write-docs skill for AI agent guidance when writing docs by @desertaxle in https://github.com/PrefectHQ/prefect/pull/20606Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.17.dev3...3.6.17.dev4
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
include_files support to @ecs decorator for bundling non-Python files by @desertaxle in https://github.com/PrefectHQ/prefect/pull/20551Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.16...3.6.17.dev1
Add prefect cloud asset list and delete commands by @zzstoatzz in #20524
New Features 🎉
prefect cloud asset list and delete commands by @zzstoatzz in #20524Enhancements ➕➕
flow and flow_run by @Rodrigorm33 in #20358max_scheduled_runs, parameters, and slug fields to deployment schedule methods by @devin-ai-integration[bot] in #20556Bug Fixes 🐞
visit_collection to handle NamedTuples by @chuqCTC in #20517JsonFormatter for logging by @devin-ai-integration[bot] in #20482deploy --all console output by @devin-ai-integration[bot] in #20511prefect by @desertaxle in #20514TaskRunContext leaking into Pending event related resources by @bunchesofdonald in #20536Development & Tidiness 🧹
clear_db auto-mark by @devin-ai-integration[bot] in #20487EXCLUDE_FROM_CLEAR_DB_AUTO_MARK by @devin-ai-integration[bot] in #20490clear_db exclusion list by @devin-ai-integration[bot] in #20491test_flow_runs.py and telemetry/ to clear_db exclusion list by @devin-ai-integration[bot] in #20492input/, deployment/, experimental/ to clear_db exclusion list by @devin-ai-integration[bot] in #20493tests/results to clear_db exclusion list by @devin-ai-integration[bot] in #20495EXCLUDE_FROM_CLEAR_DB_AUTO_MARK by @devin-ai-integration[bot] in #20504tests/events/client to clear_db exclusion list by @devin-ai-integration[bot] in #20506tests/infrastructure to clear_db exclusion list by @devin-ai-integration[bot] in #20507tests/blocks/ to EXCLUDE_FROM_CLEAR_DB_AUTO_MARK by @devin-ai-integration[bot] in #20512tests/test_task_runners.py and tests/test_variables.py to clear_db exclusion list by @devin-ai-integration[bot] in #20530tests/test_futures.py and tests/test_logging.py to clear_db exclusion list by @devin-ai-integration[bot] in #20531Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.15...3.6.16
<!-- 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.16.dev6...3.6.16.dev7
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
prefect cloud asset list and delete commands by @zzstoatzz in https://github.com/PrefectHQ/prefect/pull/20524Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.16.dev5...3.6.16.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.6.16.dev4...3.6.16.dev5
<!-- 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.16.dev3...3.6.16.dev4
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
clear_db auto-mark by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20487EXCLUDE_FROM_CLEAR_DB_AUTO_MARK by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20490Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.16.dev2...3.6.16.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.16.dev1...3.6.16.dev2
Fix PrefectCloudEventsClient auth handshake breaking Cloud connections by @desertaxle in #20472
Bug Fixes 🐞
PrefectCloudEventsClient auth handshake breaking Cloud connections by @desertaxle in #20472retry-after to prevent excessive delays from burst traffic by @bunchesofdonald in #20470Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.14...3.6.15
Support parsing TOML 1.0 on Python 3.11+ by @zed in #20398
Enhancements ➕➕
prefect server start by @zzstoatzz in #20361/api/events/in WebSocket endpoint by @devin-ai-integration[bot] in #20372Bug Fixes 🐞
PrefectFlowRunFuture.wait_async by @devin-ai-integration[bot] in #20406end_time by @devin-ai-integration[bot] in #20369flow_run.id returning string "None" instead of None by @bnaul in #20425Integrations & Dependencies 🤝
pydocket minimum version to 0.17.2 by @chrisguidry in #20405Development & Tidiness 🧹
skipif(sys.platform != 'win32') with @pytest.mark.windows and remove skipif(sys.platform == 'win32') by @devin-ai-integration[bot] in #20327pytest.approx for date_diff_seconds timing assertions by @devin-ai-integration[bot] in #20354deployments/runner.py from @sync_compatible to @async_dispatch by @zzstoatzz in #20359test_timeout_concurrency_slot_released tests by @devin-ai-integration[bot] in #20364Task.serve() from @sync_compatible to @async_dispatch by @zzstoatzz in #20374Flow.deploy() from @sync_compatible to @async_dispatch by @zzstoatzz in #20380Runner methods from @sync_compatible to @async_dispatch by @zzstoatzz in #20382TestClient as context manager for proper lifespan cleanup by @devin-ai-integration[bot] in #20426Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.13...3.6.14
<!-- 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.14.dev6...3.6.14.dev7
<!-- 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.14.dev5...3.6.14.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.6.14.dev4...3.6.14.dev5
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
PrefectFlowRunFuture.wait_async by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20406Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.14.dev3...3.6.14.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.14.dev2...3.6.14.dev3
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
prefect server start by @zzstoatzz in https://github.com/PrefectHQ/prefect/pull/20361Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.14.dev1...3.6.14.dev2
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
skipif(sys.platform != 'win32') with @pytest.mark.windows and remove skipif(sys.platform == 'win32') by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20327Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.13...3.6.14.dev1
Add FlowRunFilterCreatedBy by @zzstoatzz in #20256
Enhancements ➕➕
FlowRunFilterCreatedBy by @zzstoatzz in #20256PrefectEventsClient.__aenter__() initial connection by @devin-ai-integration[bot] in #20328Bug Fixes 🐞
AttributeError in event clients by @devin-ai-integration[bot] in #20323strip_auth_from_url into prefect._internal.urls by @zzstoatzz in #20331slot_decay_per_second None value causing 422 error in upsert_global_concurrency_limit_by_name by @devin-ai-integration[bot] in #20320hosted_api_server fixture by @devin-ai-integration[bot] in #20322Development & Tidiness 🧹
ignore_errors in rmtree for SQLite race condition by @devin-ai-integration[bot] in #20326sys.path isolation fixture for importtools tests by @devin-ai-integration[bot] in #20347task_worker.py from @sync_compatible to @async_dispatch by @zzstoatzz in #20259@sync_compatible to @async_dispatch by @zzstoatzz in #20313ResultStore from @sync_compatible to @async_dispatch by @zzstoatzz in #20314Flow.visualize from @sync_compatible to @async_dispatch by @zzstoatzz in #20353Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.12...3.6.13
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
slot_decay_per_second None value causing 422 error in upsert_global_concurrency_limit_by_name by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20320hosted_api_server fixture by @devin-ai-integration[bot] in https://github.com/PrefectHQ/prefect/pull/20322Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.13.dev1...3.6.13.dev2
Add httpx.ConnectError to client retry exceptions by @joshuastagner in #20276
Enhancements ➕➕
Bug Fixes 🐞
work-pool create command by @devin-ai-integration[bot] in #20277PrefectEventSubscriber.__aenter__() for initial connections by @devin-ai-integration[bot] in #20295Development & Tidiness 🧹
Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.11...3.6.12
This release introduces prefect sdk generate a new CLI command that generates fully-typed, custom Python SDKs from the deployments in your workspace o
Released on January 15, 2026
This release introduces prefect sdk generate a new CLI command that generates fully-typed, custom Python SDKs from the deployments in your workspace or self-hosted server, making it easy to trigger your deployments from other workflows with confidence.
To see how it works, check out the Prefect docs. This functionality is currently in beta, so try it out and open a GitHub issue if you have feedback!
New Features 🎉
prefect sdk generate CLI command for generating custom deployment SDKs from existing deployments by @desertaxle in #20150, #20158, #20167, #20172, #20173Enhancements ➕➕
prefect variable ls CLI command by @xeniumcode in #20192prefect global-concurrency-limit ls CLI command by @xeniumcode in #20194prefect artifact CLI commands by @xeniumcode in #20193prefect block ls CLI command by @xeniumcode in #20195prefect block type ls CLI command by @xeniumcode in #20196prefect deployment schedule CLI commands by @xeniumcode in #20197prefect deployment CLI commands by @xeniumcode in #20198pause, suspend, resume, and run_input from @sync_compatible to @async_dispatch by @devin-ai-integration[bot] in #20178force parameter to ChangeFlowRunState and flow_run_id Jinja filter by @zzstoatzz in #20112automation.action.* events to automation.triggered event by @chrisguidry in #20227DISABLED to client DeploymentStatus enum for Cloud compatibility by @chrisguidry in #20244Bug Fixes 🐞
prefect.yaml by @zzstoatzz in #20238updated column value of deployments when marking them as ready by @vkrot-innio in #19936Development & Tidiness 🧹
arun_deployment and replace @sync_compatible with @async_dispatch by @desertaxle in #20160test_concurrency_respects_timeout by @devin-ai-integration[bot] in #20185slot_decay_per_second to prevent race condition by @devin-ai-integration[bot] in #20208concurrency/v1 from @sync_compatible to @async_dispatch by @zzstoatzz in #20225blocks/core.py from @sync_compatible to @async_dispatch by @devin-ai-integration[bot] in #20226plans/ directory by @zzstoatzz in #20183plans/ by @desertaxle in #20207Documentation 📓
prefect sdk generate CLI by @desertaxle in #20241Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.10...3.6.11
Add prefect automation update CLI command by @devin-ai-integration[bot] in #20118
Released on January 08, 2026
Enhancements ➕➕
prefect automation update CLI command by @devin-ai-integration[bot] in #20118Bug Fixes 🐞
AttributeError in Consumer.cleanup() for non-memory brokers by @devin-ai-integration[bot] in #20089exception_to_crashed_state_sync failing without async backend by @zzstoatzz in #20139MockValSer serialization error with StateDetails by @zzstoatzz in #20127AttributeError for functools.partial hooks in Runner by @devin-ai-integration[bot] in #20136Development & Tidiness 🧹
UISettings model for /ui-settings endpoint by @desertaxle in #20103test_concurrency_respects_timeout test by @devin-ai-integration[bot] in #20138@prefecthq/prefect-ui-library to version 3.14.8 by @marvin-robot in #20147Documentation 📓
job_configuration by @zzstoatzz in #20133Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.9...3.6.10
*Released on December 31, 2025*
Released on December 31, 2025
New Features 🎉
Enhancements ➕➕
prefect.yaml files by @zzstoatzz in #19996Bug Fixes 🐞
get_directory instead of following them by @majiayu000 in #19993GitRepository name parameter preservation in pull step conversion by @devin-ai-integration[bot] in #20004ruamel.yaml.clib dependency to fix Docker builds by @zzstoatzz in #20068Development & Tidiness 🧹
@prefecthq/prefect-ui-library to version 3.14.5 by @marvin-robot in #20003Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.8...3.6.9
*Released on December 24, 2025*
Released on December 24, 2025
New Features 🎉
prefect flow-run retry command by @desertaxle in #19858Enhancements ➕➕
url property to server-side ReceivedEvent for automation templates by @devin-ai-integration[bot] in #19851Bug Fixes 🐞
preprocess_schema by @zzstoatzz in #19946form_data in CustomWebhookNotificationBlock by @zzstoatzz in #19953pydocket version and remove background worker shutdown timeout by @desertaxle in #19969TASK_SOURCE cache policy for remote execution with cloudpickle by @desertaxle in #19926Development & Tidiness 🧹
Documentation 📓
Full Changelog: https://github.com/PrefectHQ/prefect/compare/3.6.7...3.6.8
One column per quarter.