Param-a-lama-ding-dong

What's Changed

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": "jim.halpert@dundermifflin.com"}
    ),
    Cron(
      "5 8 * * *",
      parameters={
        "to": "dwight.schrute@dundermifflin.com",
        "message": "Stop goofing off! You're assistant _to_ the regional manager!"
      }
    )
  ]
)

See the documentation for more details.

Enhancements ➕➕

• Update deployments PATCH endpoint to make more targeted updates with slugs by @desertaxle in #17027
• Update deployment SDK to use slugs by @desertaxle in #17043
• Update the SDK to use PATCH /deployments/{id} endpoint for existing deployments by @desertaxle in #17050
• Add database migration that adds parameter fields to deployment schedules by @cicdw in #16947
• Add non-public implementation of parametrized schedules by @cicdw in #16951
• Allow definition of per-schedule parameter overrides via prefect.yaml by @desertaxle in #16963
• Allow definition of per-schedule parameters via .serve and .deploy by @desertaxle in #16965
• Use retry logic of underlying prefect client properly by @cicdw in #16992
• Remove some log noise in pause and abort handling by @cicdw in #17014
• Allow for updating a deployment's parameter openapi schema by @cicdw in #17016
• Allow for pull step updates on deployments by @cicdw in #17045

Bug Fixes 🐞

• Remove unused function by @cicdw in #16923
• fix create_markdown_artifact usage in prefect-dbt by @zzstoatzz in #16926
• Add fix for creating profile with default name conflict by @cicdw in #16932
• Fix: Event cleaning without timeouts by @NobisIndustries in #16921
• fix handling for bad host with prefect server start by @zzstoatzz in #16960
• Add suggestion to pause schedules prior to upgrading by @cicdw in #16970
• Target wait warning to more specific circumstances by @cicdw in #16969
• support anonymous volumes in docker work pool by @zzstoatzz in #17022
• pin core above 3.1.15 for prefect-dbt by @zzstoatzz in #17010
• Refactor to_state_create by @cicdw in #17033
• Reject task run state change if the cache key is too large by @bunchesofdonald in #16914

Integrations & Dependencies 🤝

• Bumps to ruff==0.9.2 and mypy==1.14.1 by @chrisguidry in #16916
• Add dbt profiles utilities by @kevingrismore in #16889
• Update pytz requirement from <2025,>=2021.1 to >=2021.1,<2026 by @dependabot in #16936
• Bump ruff from 0.9.2 to 0.9.4 by @dependabot in #16935
• Add PrefectDbtRunner by @kevingrismore in #16971
• fix: include region_name when creating aws clients by @obendidi in #16811

Development & Tidiness 🧹

• more pendulum consolidation by @zzstoatzz in #16911
• fix emit_event docstring by @zzstoatzz in #16918
• Update @prefecthq/prefect-ui-library to version 3.11.39 by @marvin-robot in #16919
• Fix prefect-dask test suite by @desertaxle in #16920
• refactor work pool client methods by @aaazzam in #16661
• Update @prefecthq/prefect-ui-library to version 3.11.40 by @marvin-robot in #16929
• Update @prefecthq/prefect-ui-library to version 3.11.41 by @marvin-robot in #16930
• more pendulum consolidation by @zzstoatzz in #16922
• Unifies background service running between the web server and CLI by @chrisguidry in #16927
• rm pendulum use in schedules.py by @zzstoatzz in #16943
• Add file exclusion to codeowners by @cicdw in #16957
• Update a few more small things for labeler and review tags by @cicdw in #16958
• Remove switching logic within settings config by @cicdw in #16961
• Remove failure flag by @cicdw in #16974
• Use nvm in pre-commit hooks by @cicdw in #16975
• Fix labeler to remove unnecessary labels by @cicdw in #17009
• Remove full team from schema json updates by @cicdw in #17008
• Fix migration downgrades on deployment schedule table by @cicdw in #17044
• Refactor results and result records to improve circular import situation by @cicdw in #17031
• Update @prefecthq/prefect-ui-library to version 3.11.42 by @marvin-robot in #17046

Documentation 📓

• Consolidates discovery of Prefect server Services to the base class by @chrisguidry in #16913
• Enhancement: Add New SLA Types by @dylanbhughes in #16902
• add notes on TASK_SOURCE behavior by @zzstoatzz in #16928
• fix(docs): small quickstart fixes by @mitchnielsen in #16931
• Chore: Add /reference redirects by @znicholasbrown in #16980
• chore: Add additional reference redirects by @jimid27 in #16993
• Update a few more links to the SDK reference by @daniel-prefect in #16997
• add docs on per-schedule parameters by @zzstoatzz in #17000
• add cli docs by @aaazzam in #17037

New Contributors

• @devangrose made their first contribution in #16893
• @obendidi made their first contribution in #16811

Full Changelog: 3.1.15...3.2.0