From 7dcfecf6064f721efdbf5231df0e963a7125e6b3 Mon Sep 17 00:00:00 2001
From: Yurii Motov <yurii.motov.monte@gmail.com>
Date: Tue, 25 Nov 2025 20:45:45 +0100
Subject: [PATCH] Add `scope` parameter to `Security`

---
 fastapi/param_functions.py | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/fastapi/param_functions.py b/fastapi/param_functions.py
index f9389e0cd..eee7542fa 100644
--- a/fastapi/param_functions.py
+++ b/fastapi/param_functions.py
@@ -2386,7 +2386,26 @@ def Security(  # noqa: N802
             ```python
             Security(dependency_fn, oauth_scopes=["items", "users"])
             ```
-            )
+            """
+        ),
+    ] = None,
+    scope: Annotated[
+        Union[Literal["function", "request"], None],
+        Doc(
+            """
+            Mainly for dependencies with `yield`, define when the dependency function
+            should start (the code before `yield`) and when it should end (the code
+            after `yield`).
+
+            * `"function"`: start the dependency before the *path operation function*
+                that handles the request, end the dependency after the *path operation
+                function* ends, but **before** the response is sent back to the client.
+                So, the dependency function will be executed **around** the *path operation
+                **function***.
+            * `"request"`: start the dependency before the *path operation function*
+                that handles the request (similar to when using `"function"`), but end
+                **after** the response is sent back to the client. So, the dependency
+                function will be executed **around** the **request** and response cycle.
             """
         ),
     ] = None,
@@ -2480,4 +2499,5 @@ def Security(  # noqa: N802
         dependency=dependency,
         oauth_scopes=oauth_scopes,
         use_cache=use_cache,
+        scope=scope,
     )