prefect 3.4.8.dev4__tar.gz → 3.4.8.dev6__tar.gz

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect
-Version: 3.4.8.dev4
+Version: 3.4.8.dev6
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io
@@ -72,7 +72,6 @@ Requires-Dist: sqlalchemy[asyncio]<3.0.0,>=2.0
 Requires-Dist: toml>=0.10.0
 Requires-Dist: typer!=0.12.2,<0.17.0,>=0.12.0
 Requires-Dist: typing-extensions<5.0.0,>=4.10.0
-Requires-Dist: ujson<6.0.0,>=5.8.0
 Requires-Dist: uv>=0.6.0
 Requires-Dist: uvicorn!=0.29.0,>=0.14.0
 Requires-Dist: websockets<16.0,>=13.0

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/pyproject.toml

@@ -78,7 +78,6 @@ dependencies = [
     "sniffio>=1.3.0,<2.0.0",
     "toml>=0.10.0",
     "typing_extensions>=4.10.0,<5.0.0",
-    "ujson>=5.8.0,<6.0.0",
     "uvicorn>=0.14.0,!=0.29.0",
     "websockets>=13.0,<16.0",
     "whenever>=0.7.3,<0.9.0; python_version>='3.13'",

prefect-3.4.8.dev6/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.4.8.dev6"
+__build_date__ = "2025-07-08 08:10:00.821334+00:00"
+__git_commit__ = "4a2db7097d87714e8d401d9ebfe5954a4fa77cb2"
+__dirty__ = False

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/_internal/compatibility/async_dispatch.py

@@ -93,6 +93,9 @@ def async_dispatch(
             fn = sync_fn if should_run_sync else async_impl
             return fn(*args, **kwargs)
 
+        # Add the .aio attribute for compatibility with existing code that expects it
+        # (e.g., CLI commands, tests that mock .aio)
+        wrapper.aio = async_impl  # type: ignore
         return wrapper
 
     return decorator

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/deployments/runner.py

@@ -379,8 +379,10 @@ class RunnerDeployment(BaseModel):
                     pull_steps = self.storage.to_pull_step()
                     if isinstance(pull_steps, list):
                         create_payload["pull_steps"] = pull_steps
-                    else:
+                    elif pull_steps:
                         create_payload["pull_steps"] = [pull_steps]
+                    else:
+                        create_payload["pull_steps"] = []
                 else:
                     create_payload["pull_steps"] = []
 
@@ -426,9 +428,11 @@ class RunnerDeployment(BaseModel):
 
         if self.storage:
             pull_steps = self.storage.to_pull_step()
-            if not isinstance(pull_steps, list):
+            if pull_steps and not isinstance(pull_steps, list):
                 pull_steps = [pull_steps]
             update_payload["pull_steps"] = pull_steps
+        else:
+            update_payload["pull_steps"] = None
 
         await client.update_deployment(
             deployment_id,

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/filesystems.py

@@ -10,6 +10,7 @@ import anyio
 import fsspec
 from pydantic import BaseModel, Field, SecretStr, field_validator
 
+from prefect._internal.compatibility.async_dispatch import async_dispatch
 from prefect._internal.schemas.validators import (
     stringify_path,
     validate_basepath,
@@ -126,8 +127,7 @@ class LocalFileSystem(WritableFileSystem, WritableDeploymentStorage):
                 )
         return resolved_path
 
-    @sync_compatible
-    async def get_directory(
+    async def aget_directory(
         self, from_path: Optional[str] = None, local_path: Optional[str] = None
     ) -> None:
         """
@@ -161,6 +161,50 @@ class LocalFileSystem(WritableFileSystem, WritableDeploymentStorage):
 
         copytree(from_path, local_path, dirs_exist_ok=True, ignore=ignore_func)
 
+    @async_dispatch(aget_directory)
+    def get_directory(
+        self, from_path: Optional[str] = None, local_path: Optional[str] = None
+    ) -> None:
+        """
+        Copies a directory from one place to another on the local filesystem.
+
+        Defaults to copying the entire contents of the block's basepath to the current working directory.
+        """
+        if not from_path:
+            from_path = Path(self.basepath or ".").expanduser().resolve()
+        else:
+            from_path = self._resolve_path(from_path)
+
+        if not local_path:
+            local_path = Path(".").resolve()
+        else:
+            local_path = Path(local_path).resolve()
+
+        if from_path == local_path:
+            # If the paths are the same there is no need to copy
+            # and we avoid shutil.copytree raising an error
+            return
+
+        # .prefectignore exists in the original location, not the current location which
+        # is most likely temporary
+        if (from_path / Path(".prefectignore")).exists():
+            with open(from_path / Path(".prefectignore")) as f:
+                ignore_patterns = f.readlines()
+            included_files = filter_files(
+                root=from_path, ignore_patterns=ignore_patterns
+            )
+
+            def ignore_func(directory, files):
+                relative_path = Path(directory).relative_to(from_path)
+                files_to_ignore = [
+                    f for f in files if str(relative_path / f) not in included_files
+                ]
+                return files_to_ignore
+        else:
+            ignore_func = None
+
+        copytree(from_path, local_path, dirs_exist_ok=True, ignore=ignore_func)
+
     async def _get_ignore_func(self, local_path: str, ignore_file: str):
         with open(ignore_file) as f:
             ignore_patterns = f.readlines()
@@ -176,8 +220,7 @@ class LocalFileSystem(WritableFileSystem, WritableDeploymentStorage):
 
         return ignore_func
 
-    @sync_compatible
-    async def put_directory(
+    async def aput_directory(
         self,
         local_path: Optional[str] = None,
         to_path: Optional[str] = None,
@@ -211,8 +254,51 @@ class LocalFileSystem(WritableFileSystem, WritableDeploymentStorage):
                 dirs_exist_ok=True,
             )
 
-    @sync_compatible
-    async def read_path(self, path: str) -> bytes:
+    @async_dispatch(aput_directory)
+    def put_directory(
+        self,
+        local_path: Optional[str] = None,
+        to_path: Optional[str] = None,
+        ignore_file: Optional[str] = None,
+    ) -> None:
+        """
+        Copies a directory from one place to another on the local filesystem.
+
+        Defaults to copying the entire contents of the current working directory to the block's basepath.
+        An `ignore_file` path may be provided that can include gitignore style expressions for filepaths to ignore.
+        """
+        destination_path = self._resolve_path(to_path, validate=True)
+
+        if not local_path:
+            local_path = Path(".")
+
+        if ignore_file:
+            with open(ignore_file) as f:
+                ignore_patterns = f.readlines()
+            included_files = filter_files(
+                root=local_path, ignore_patterns=ignore_patterns
+            )
+
+            def ignore_func(directory, files):
+                relative_path = Path(directory).relative_to(local_path)
+                files_to_ignore = [
+                    f for f in files if str(relative_path / f) not in included_files
+                ]
+                return files_to_ignore
+        else:
+            ignore_func = None
+
+        if local_path == destination_path:
+            pass
+        else:
+            copytree(
+                src=local_path,
+                dst=destination_path,
+                ignore=ignore_func,
+                dirs_exist_ok=True,
+            )
+
+    async def aread_path(self, path: str) -> bytes:
         path: Path = self._resolve_path(path)
 
         # Check if the path exists
@@ -228,8 +314,24 @@ class LocalFileSystem(WritableFileSystem, WritableDeploymentStorage):
 
         return content
 
-    @sync_compatible
-    async def write_path(self, path: str, content: bytes) -> str:
+    @async_dispatch(aread_path)
+    def read_path(self, path: str) -> bytes:
+        path: Path = self._resolve_path(path)
+
+        # Check if the path exists
+        if not path.exists():
+            raise ValueError(f"Path {path} does not exist.")
+
+        # Validate that its a file
+        if not path.is_file():
+            raise ValueError(f"Path {path} is not a file.")
+
+        with open(str(path), mode="rb") as f:
+            content = f.read()
+
+        return content
+
+    async def awrite_path(self, path: str, content: bytes) -> str:
         path: Path = self._resolve_path(path)
 
         # Construct the path if it does not exist
@@ -244,6 +346,22 @@ class LocalFileSystem(WritableFileSystem, WritableDeploymentStorage):
         # Leave path stringify to the OS
         return str(path)
 
+    @async_dispatch(awrite_path)
+    def write_path(self, path: str, content: bytes) -> str:
+        path: Path = self._resolve_path(path)
+
+        # Construct the path if it does not exist
+        path.parent.mkdir(exist_ok=True, parents=True)
+
+        # Check if the file already exists
+        if path.exists() and not path.is_file():
+            raise ValueError(f"Path {path} already exists and is not a file.")
+
+        with open(path, mode="wb") as f:
+            f.write(content)
+        # Leave path stringify to the OS
+        return str(path)
+
 
 class RemoteFileSystem(WritableFileSystem, WritableDeploymentStorage):
     """

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/runner/runner.py

@@ -1450,10 +1450,10 @@ class Runner:
                 hooks = flow.on_cancellation_hooks or []
 
                 await _run_hooks(hooks, flow_run, flow, state)
-            except ObjectNotFound:
-                run_logger = self._get_flow_run_logger(flow_run)
+            except Exception:
                 run_logger.warning(
-                    f"Runner failed to retrieve flow to execute on_cancellation hooks for flow run {flow_run.id!r}."
+                    f"Runner failed to retrieve flow to execute on_cancellation hooks for flow run {flow_run.id!r}.",
+                    exc_info=True,
                 )
 
     async def _run_on_crashed_hooks(
@@ -1479,9 +1479,10 @@ class Runner:
                 hooks = flow.on_crashed_hooks or []
 
                 await _run_hooks(hooks, flow_run, flow, state)
-            except ObjectNotFound:
+            except Exception:
                 run_logger.warning(
-                    f"Runner failed to retrieve flow to execute on_crashed hooks for flow run {flow_run.id!r}."
+                    f"Runner failed to retrieve flow to execute on_crashed hooks for flow run {flow_run.id!r}.",
+                    exc_info=True,
                 )
 
     async def __aenter__(self) -> Self:

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/server/api/artifacts.py

@@ -46,7 +46,7 @@ async def create_artifact(
     return model
 
 
-@router.get("/{id}")
+@router.get("/{id:uuid}")
 async def read_artifact(
     artifact_id: UUID = Path(
         ..., description="The ID of the artifact to retrieve.", alias="id"
@@ -189,7 +189,7 @@ async def count_latest_artifacts(
         )
 
 
-@router.patch("/{id}", status_code=204)
+@router.patch("/{id:uuid}", status_code=204)
 async def update_artifact(
     artifact: actions.ArtifactUpdate,
     artifact_id: UUID = Path(
@@ -210,7 +210,7 @@ async def update_artifact(
         raise HTTPException(status_code=404, detail="Artifact not found.")
 
 
-@router.delete("/{id}", status_code=204)
+@router.delete("/{id:uuid}", status_code=204)
 async def delete_artifact(
     artifact_id: UUID = Path(
         ..., description="The ID of the artifact to delete.", alias="id"

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/server/api/block_schemas.py

@@ -69,7 +69,7 @@ async def create_block_schema(
         return model
 
 
-@router.delete("/{id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.delete("/{id:uuid}", status_code=status.HTTP_204_NO_CONTENT)
 async def delete_block_schema(
     block_schema_id: UUID = Path(..., description="The block schema id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -118,7 +118,7 @@ async def read_block_schemas(
     return result
 
 
-@router.get("/{id}")
+@router.get("/{id:uuid}")
 async def read_block_schema_by_id(
     block_schema_id: UUID = Path(..., description="The block schema id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/server/api/block_types.py

@@ -43,7 +43,7 @@ async def create_block_type(
     return created_block_type
 
 
-@router.get("/{id}")
+@router.get("/{id:uuid}")
 async def read_block_type_by_id(
     block_type_id: UUID = Path(..., description="The block type ID", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -98,7 +98,7 @@ async def read_block_types(
         )
 
 
-@router.patch("/{id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.patch("/{id:uuid}", status_code=status.HTTP_204_NO_CONTENT)
 async def update_block_type(
     block_type: schemas.actions.BlockTypeUpdate,
     block_type_id: UUID = Path(..., description="The block type ID", alias="id"),
@@ -129,7 +129,7 @@ async def update_block_type(
             )
 
 
-@router.delete("/{id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.delete("/{id:uuid}", status_code=status.HTTP_204_NO_CONTENT)
 async def delete_block_type(
     block_type_id: UUID = Path(..., description="The block type ID", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/server/api/concurrency_limits.py

@@ -49,7 +49,7 @@ async def create_concurrency_limit(
     return model
 
 
-@router.get("/{id}")
+@router.get("/{id:uuid}")
 async def read_concurrency_limit(
     concurrency_limit_id: UUID = Path(
         ..., description="The concurrency limit id", alias="id"
@@ -137,7 +137,7 @@ async def reset_concurrency_limit_by_tag(
         )
 
 
-@router.delete("/{id}")
+@router.delete("/{id:uuid}")
 async def delete_concurrency_limit(
     concurrency_limit_id: UUID = Path(
         ..., description="The concurrency limit id", alias="id"

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/server/api/deployments.py

@@ -201,7 +201,7 @@ async def create_deployment(
         )
 
 
-@router.patch("/{id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.patch("/{id:uuid}", status_code=status.HTTP_204_NO_CONTENT)
 async def update_deployment(
     deployment: schemas.actions.DeploymentUpdate,
     deployment_id: UUID = Path(..., description="The deployment id", alias="id"),
@@ -389,7 +389,7 @@ async def read_deployment_by_name(
         )
 
 
-@router.get("/{id}")
+@router.get("/{id:uuid}")
 async def read_deployment(
     deployment_id: UUID = Path(..., description="The deployment id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -585,7 +585,7 @@ async def count_deployments(
         )
 
 
-@router.delete("/{id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.delete("/{id:uuid}", status_code=status.HTTP_204_NO_CONTENT)
 async def delete_deployment(
     deployment_id: UUID = Path(..., description="The deployment id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -603,7 +603,7 @@ async def delete_deployment(
         )
 
 
-@router.post("/{id}/schedule")
+@router.post("/{id:uuid}/schedule")
 async def schedule_deployment(
     deployment_id: UUID = Path(..., description="The deployment id", alias="id"),
     start_time: datetime.datetime = Body(
@@ -702,7 +702,7 @@ async def pause_deployment(
         await session.commit()
 
 
-@router.post("/{id}/create_flow_run")
+@router.post("/{id:uuid}/create_flow_run")
 async def create_flow_run_from_deployment(
     flow_run: schemas.actions.DeploymentFlowRunCreate,
     deployment_id: UUID = Path(..., description="The deployment id", alias="id"),
@@ -835,7 +835,7 @@ async def create_flow_run_from_deployment(
 
 
 # DEPRECATED
-@router.get("/{id}/work_queue_check", deprecated=True)
+@router.get("/{id:uuid}/work_queue_check", deprecated=True)
 async def work_queue_check_for_deployment(
     deployment_id: UUID = Path(..., description="The deployment id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -861,7 +861,7 @@ async def work_queue_check_for_deployment(
     return work_queues
 
 
-@router.get("/{id}/schedules")
+@router.get("/{id:uuid}/schedules")
 async def read_deployment_schedules(
     deployment_id: UUID = Path(..., description="The deployment id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -882,7 +882,7 @@ async def read_deployment_schedules(
         )
 
 
-@router.post("/{id}/schedules", status_code=status.HTTP_201_CREATED)
+@router.post("/{id:uuid}/schedules", status_code=status.HTTP_201_CREATED)
 async def create_deployment_schedules(
     deployment_id: UUID = Path(..., description="The deployment id", alias="id"),
     schedules: List[schemas.actions.DeploymentScheduleCreate] = Body(
@@ -916,7 +916,9 @@ async def create_deployment_schedules(
         return created
 
 
-@router.patch("/{id}/schedules/{schedule_id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.patch(
+    "/{id:uuid}/schedules/{schedule_id:uuid}", status_code=status.HTTP_204_NO_CONTENT
+)
 async def update_deployment_schedule(
     deployment_id: UUID = Path(..., description="The deployment id", alias="id"),
     schedule_id: UUID = Path(..., description="The schedule id", alias="schedule_id"),
@@ -953,7 +955,9 @@ async def update_deployment_schedule(
         )
 
 
-@router.delete("/{id}/schedules/{schedule_id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.delete(
+    "/{id:uuid}/schedules/{schedule_id:uuid}", status_code=status.HTTP_204_NO_CONTENT
+)
 async def delete_deployment_schedule(
     deployment_id: UUID = Path(..., description="The deployment id", alias="id"),
     schedule_id: UUID = Path(..., description="The schedule id", alias="schedule_id"),

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/server/api/flow_run_states.py

@@ -17,7 +17,7 @@ router: PrefectRouter = PrefectRouter(
 )
 
 
-@router.get("/{id}")
+@router.get("/{id:uuid}")
 async def read_flow_run_state(
     flow_run_state_id: UUID = Path(
         ..., description="The flow run state id", alias="id"

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/server/api/flow_runs.py

@@ -125,7 +125,7 @@ async def create_flow_run(
         )
 
 
-@router.patch("/{id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.patch("/{id:uuid}", status_code=status.HTTP_204_NO_CONTENT)
 async def update_flow_run(
     flow_run: schemas.actions.FlowRunUpdate,
     flow_run_id: UUID = Path(..., description="The flow run id", alias="id"),
@@ -316,7 +316,7 @@ async def flow_run_history(
         )
 
 
-@router.get("/{id}")
+@router.get("/{id:uuid}")
 async def read_flow_run(
     flow_run_id: UUID = Path(..., description="The flow run id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -335,7 +335,7 @@ async def read_flow_run(
         )
 
 
-@router.get("/{id}/graph", tags=["Flow Run Graph"])
+@router.get("/{id:uuid}/graph", tags=["Flow Run Graph"])
 async def read_flow_run_graph_v1(
     flow_run_id: UUID = Path(..., description="The flow run id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -375,7 +375,7 @@ async def read_flow_run_graph_v2(
             )
 
 
-@router.post("/{id}/resume")
+@router.post("/{id:uuid}/resume")
 async def resume_flow_run(
     flow_run_id: UUID = Path(..., description="The flow run id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -568,7 +568,7 @@ async def read_flow_runs(
         return ORJSONResponse(content=encoded)
 
 
-@router.delete("/{id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.delete("/{id:uuid}", status_code=status.HTTP_204_NO_CONTENT)
 async def delete_flow_run(
     flow_run_id: UUID = Path(..., description="The flow run id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -586,7 +586,7 @@ async def delete_flow_run(
         )
 
 
-@router.post("/{id}/set_state")
+@router.post("/{id:uuid}/set_state")
 async def set_flow_run_state(
     flow_run_id: UUID = Path(..., description="The flow run id", alias="id"),
     state: schemas.actions.StateCreate = Body(..., description="The intended state."),
@@ -637,7 +637,7 @@ async def set_flow_run_state(
     return orchestration_result
 
 
-@router.post("/{id}/input", status_code=status.HTTP_201_CREATED)
+@router.post("/{id:uuid}/input", status_code=status.HTTP_201_CREATED)
 async def create_flow_run_input(
     flow_run_id: UUID = Path(..., description="The flow run id", alias="id"),
     key: str = Body(..., description="The input key"),
@@ -673,7 +673,7 @@ async def create_flow_run_input(
                 )
 
 
-@router.post("/{id}/input/filter")
+@router.post("/{id:uuid}/input/filter")
 async def filter_flow_run_input(
     flow_run_id: UUID = Path(..., description="The flow run id", alias="id"),
     prefix: str = Body(..., description="The input key prefix", embed=True),
@@ -698,7 +698,7 @@ async def filter_flow_run_input(
         )
 
 
-@router.get("/{id}/input/{key}")
+@router.get("/{id:uuid}/input/{key}")
 async def read_flow_run_input(
     flow_run_id: UUID = Path(..., description="The flow run id", alias="id"),
     key: str = Path(..., description="The input key", alias="key"),
@@ -721,7 +721,7 @@ async def read_flow_run_input(
         )
 
 
-@router.delete("/{id}/input/{key}", status_code=status.HTTP_204_NO_CONTENT)
+@router.delete("/{id:uuid}/input/{key}", status_code=status.HTTP_204_NO_CONTENT)
 async def delete_flow_run_input(
     flow_run_id: UUID = Path(..., description="The flow run id", alias="id"),
     key: str = Path(..., description="The input key", alias="key"),
@@ -810,7 +810,7 @@ async def paginate_flow_runs(
 FLOW_RUN_LOGS_DOWNLOAD_PAGE_LIMIT = 1000
 
 
-@router.get("/{id}/logs/download")
+@router.get("/{id:uuid}/logs/download")
 async def download_logs(
     flow_run_id: UUID = Path(..., description="The flow run id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -876,7 +876,7 @@ async def download_logs(
         )
 
 
-@router.patch("/{id}/labels", status_code=status.HTTP_204_NO_CONTENT)
+@router.patch("/{id:uuid}/labels", status_code=status.HTTP_204_NO_CONTENT)
 async def update_flow_run_labels(
     flow_run_id: UUID = Path(..., description="The flow run id", alias="id"),
     labels: Dict[str, Any] = Body(..., description="The labels to update"),

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/server/api/flows.py

@@ -43,7 +43,7 @@ async def create_flow(
     return model
 
 
-@router.patch("/{id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.patch("/{id:uuid}", status_code=status.HTTP_204_NO_CONTENT)
 async def update_flow(
     flow: schemas.actions.FlowUpdate,
     flow_id: UUID = Path(..., description="The flow id", alias="id"),
@@ -102,7 +102,7 @@ async def read_flow_by_name(
     return flow
 
 
-@router.get("/{id}")
+@router.get("/{id:uuid}")
 async def read_flow(
     flow_id: UUID = Path(..., description="The flow id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -148,7 +148,7 @@ async def read_flows(
         )
 
 
-@router.delete("/{id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.delete("/{id:uuid}", status_code=status.HTTP_204_NO_CONTENT)
 async def delete_flow(
     flow_id: UUID = Path(..., description="The flow id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/server/api/saved_searches.py

@@ -45,7 +45,7 @@ async def create_saved_search(
     return model
 
 
-@router.get("/{id}")
+@router.get("/{id:uuid}")
 async def read_saved_search(
     saved_search_id: UUID = Path(..., description="The saved search id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -81,7 +81,7 @@ async def read_saved_searches(
         )
 
 
-@router.delete("/{id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.delete("/{id:uuid}", status_code=status.HTTP_204_NO_CONTENT)
 async def delete_saved_search(
     saved_search_id: UUID = Path(..., description="The saved search id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/server/api/task_run_states.py

@@ -17,7 +17,7 @@ router: PrefectRouter = PrefectRouter(
 )
 
 
-@router.get("/{id}")
+@router.get("/{id:uuid}")
 async def read_task_run_state(
     task_run_state_id: UUID = Path(
         ..., description="The task run state id", alias="id"

{prefect-3.4.8.dev4 → prefect-3.4.8.dev6}/src/prefect/server/api/task_runs.py

@@ -90,7 +90,7 @@ async def create_task_run(
     return new_task_run
 
 
-@router.patch("/{id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.patch("/{id:uuid}", status_code=status.HTTP_204_NO_CONTENT)
 async def update_task_run(
     task_run: schemas.actions.TaskRunUpdate,
     task_run_id: UUID = Path(..., description="The task run id", alias="id"),
@@ -174,7 +174,7 @@ async def task_run_history(
         )
 
 
-@router.get("/{id}")
+@router.get("/{id:uuid}")
 async def read_task_run(
     task_run_id: UUID = Path(..., description="The task run id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -265,7 +265,7 @@ async def paginate_task_runs(
         )
 
 
-@router.delete("/{id}", status_code=status.HTTP_204_NO_CONTENT)
+@router.delete("/{id:uuid}", status_code=status.HTTP_204_NO_CONTENT)
 async def delete_task_run(
     task_run_id: UUID = Path(..., description="The task run id", alias="id"),
     db: PrefectDBInterface = Depends(provide_database_interface),
@@ -281,7 +281,7 @@ async def delete_task_run(
         raise HTTPException(status.HTTP_404_NOT_FOUND, detail="Task not found")
 
 
-@router.post("/{id}/set_state")
+@router.post("/{id:uuid}/set_state")
 async def set_task_run_state(
     task_run_id: UUID = Path(..., description="The task run id", alias="id"),
     state: schemas.actions.StateCreate = Body(..., description="The intended state."),