📝 Update release notes

[skip ci]

.pre-commit-config.yaml

@@ -45,7 +45,7 @@ repos:
 
       - id: local-ty
         name: ty check
-        entry: uv run ty check fastapi
+        entry: uv run ty check fastapi docs_src --force-exclude
         require_serial: true
         language: unsupported
         pass_filenames: false

docs/en/docs/release-notes.md

@@ -7,6 +7,17 @@ hide:
 
 ## Latest Changes
 
+### Internal
+
+* 🔧 Add ty configs to check docs sources. PR [#15769](https://github.com/fastapi/fastapi/pull/15769) by [@tiangolo](https://github.com/tiangolo).
+
+## 0.137.1 (2026-06-15)
+
+### Fixes
+
+* 🚨 Fix typing checks for APIRoute. PR [#15765](https://github.com/fastapi/fastapi/pull/15765) by [@tiangolo](https://github.com/tiangolo).
+* 🐛 Fix bug, allow empty path in path operation in prefixless router. PR [#15763](https://github.com/fastapi/fastapi/pull/15763) by [@tiangolo](https://github.com/tiangolo).
+
 ## 0.137.0 (2026-06-14)
 
 ### Breaking Changes

docs/fr/docs/index.md

@@ -143,7 +143,7 @@ Les principales fonctionnalités sont :
 
 ---
 
-« _Si quelqu’un cherche à construire une API Python de production, je recommande vivement **FastAPI**. Il est **magnifiquement conçu**, **simple à utiliser** et **hautement scalable**, il est devenu un **composant clé** de notre stratégie de développement API-first et alimente de nombreuses automatisations et services tels que notre Virtual TAC Engineer._ »
+« _Si quelqu’un cherche à construire une API Python de production, je recommande vivement **FastAPI**. Il est **magnifiquement conçu**, **simple à utiliser** et **hautement scalable** — il est devenu un **composant clé** de notre stratégie de développement API-first._ »
 
 <div style="text-align: right; margin-right: 10%;">Deon Pillsbury - <strong>Cisco</strong> <a href="https://www.linkedin.com/posts/deonpillsbury_cisco-cx-python-activity-6963242628536487936-trAp/"><small>(ref)</small></a></div>
 
@@ -492,7 +492,9 @@ Pour un exemple plus complet comprenant plus de fonctionnalités, voir le <a hre
 
 ### Déployer votre application (optionnel) { #deploy-your-app-optional }
 
-Vous pouvez, si vous le souhaitez, déployer votre application FastAPI sur [FastAPI Cloud](https://fastapicloud.com) avec une seule commande. 🚀
+Vous pouvez, si vous le souhaitez, déployer votre application FastAPI sur [FastAPI Cloud](https://fastapicloud.com), allez vous inscrire sur la liste d'attente si ce n'est pas déjà fait. 🚀
+
+Si vous avez déjà un compte **FastAPI Cloud** (nous vous avons invité depuis la liste d'attente 😉), vous pouvez déployer votre application avec une seule commande.
 
 <div class="termy">
 
@@ -508,8 +510,6 @@ Deploying to FastAPI Cloud...
 
 </div>
 
-La CLI détectera automatiquement votre application FastAPI et la déploiera dans le cloud. Si vous n'êtes pas connecté, votre navigateur s'ouvrira pour terminer le processus d'authentification.
-
 C'est tout ! Vous pouvez maintenant accéder à votre application à cette URL. ✨
 
 #### À propos de FastAPI Cloud { #about-fastapi-cloud }

docs/fr/docs/tutorial/body-multiple-params.md

@@ -108,7 +108,7 @@ Par exemple :
 
 {* ../../docs_src/body_multiple_params/tutorial004_an_py310.py hl[28] *}
 
-/// note | Remarque
+/// info
 
 `Body` possède également les mêmes paramètres supplémentaires de validation et de métadonnées que `Query`, `Path` et d'autres que vous verrez plus tard.
 
@@ -123,7 +123,7 @@ Par défaut, **FastAPI** attendra alors son contenu directement.
 Mais si vous voulez qu'il attende un JSON avec une clé `item` contenant le contenu du modèle, comme lorsqu'on déclare des paramètres supplémentaires du corps de la requête, vous pouvez utiliser le paramètre spécial `embed` de `Body` :
 
 ```Python
-item: Annotated[Item, Body(embed=True)]
+item: Item = Body(embed=True)
 ```
 
 comme dans :

docs/fr/docs/tutorial/cookie-params.md

@@ -24,13 +24,13 @@ Mais rappelez-vous que lorsque vous importez `Query`, `Path`, `Cookie` et d'autr
 
 ///
 
-/// note | Remarque
+/// info
 
 Pour déclarer des cookies, vous devez utiliser `Cookie`, sinon les paramètres seraient interprétés comme des paramètres de requête.
 
 ///
 
-/// note | Remarque
+/// info
 
 Gardez à l'esprit que, comme **les navigateurs gèrent les cookies** de manière particulière et en coulisses, ils **n'autorisent pas** facilement **JavaScript** à y accéder.
 

docs/fr/docs/tutorial/debugging.md

@@ -72,7 +72,7 @@ Ainsi, la ligne :
 
 ne sera pas exécutée.
 
-/// note | Remarque
+/// info
 
 Pour plus d'informations, consultez [la documentation officielle de Python](https://docs.python.org/3/library/__main__.html).
 

docs/fr/docs/tutorial/path-operation-configuration.md

@@ -72,13 +72,13 @@ Vous pouvez spécifier la description de la réponse avec le paramètre `respons
 
 {* ../../docs_src/path_operation_configuration/tutorial005_py310.py hl[18] *}
 
-/// note | Remarque
+/// info
 
 Notez que `response_description` se réfère spécifiquement à la réponse, tandis que `description` se réfère au *chemin d'accès* en général.
 
 ///
 
-/// tip | Astuce
+/// check | Vérifications
 
 OpenAPI spécifie que chaque *chemin d'accès* requiert une description de réponse.
 

docs/fr/docs/tutorial/path-params-numeric-validations.md

@@ -8,7 +8,7 @@ Tout d'abord, importez `Path` de `fastapi`, et importez `Annotated` :
 
 {* ../../docs_src/path_params_numeric_validations/tutorial001_an_py310.py hl[1,3] *}
 
-/// note | Remarque
+/// info
 
 FastAPI a ajouté le support pour `Annotated` (et a commencé à le recommander) dans la version 0.95.0.
 
@@ -131,7 +131,7 @@ Et vous pouvez également déclarer des validations numériques :
 * `lt` : `l`ess `t`han
 * `le` : `l`ess than or `e`qual
 
-/// note | Remarque
+/// info
 
 `Query`, `Path`, et d'autres classes que vous verrez plus tard sont des sous-classes d'une classe commune `Param`.
 

docs/fr/docs/tutorial/request-files.md

@@ -2,7 +2,7 @@
 
 Vous pouvez définir des fichiers à téléverser par le client en utilisant `File`.
 
-/// note | Remarque
+/// info
 
 Pour recevoir des fichiers téléversés, installez d'abord [`python-multipart`](https://github.com/Kludex/python-multipart).
 
@@ -28,7 +28,7 @@ Créez des paramètres de fichier de la même manière que pour `Body` ou `Form`
 
 {* ../../docs_src/request_files/tutorial001_an_py310.py hl[9] *}
 
-/// note | Remarque
+/// info
 
 `File` est une classe qui hérite directement de `Form`.
 
@@ -44,7 +44,7 @@ Pour déclarer des fichiers dans le corps de la requête, vous devez utiliser `F
 
 Les fichiers seront téléversés en « données de formulaire ».
 
-Si vous déclarez le type de votre *fonction de chemin d'accès* comme `bytes`, **FastAPI** lira le fichier pour vous et vous recevrez le contenu sous forme de `bytes`.
+Si vous déclarez le type de votre paramètre de *fonction de chemin d'accès* comme `bytes`, **FastAPI** lira le fichier pour vous et vous recevrez le contenu sous forme de `bytes`.
 
 Gardez à l'esprit que cela signifie que tout le contenu sera stocké en mémoire. Cela fonctionnera bien pour de petits fichiers.
 

docs/fr/docs/tutorial/request-forms-and-files.md

@@ -2,7 +2,7 @@
 
 Vous pouvez définir des fichiers et des champs de formulaire en même temps à l'aide de `File` et `Form`.
 
-/// note | Remarque
+/// info
 
 Pour recevoir des fichiers téléversés et/ou des données de formulaire, installez d'abord [`python-multipart`](https://github.com/Kludex/python-multipart).
 

docs/fr/docs/tutorial/response-status-code.md

@@ -18,7 +18,7 @@ Remarquez que `status_code` est un paramètre de la méthode « decorator » (`g
 
 Le paramètre `status_code` reçoit un nombre correspondant au code d'état HTTP.
 
-/// note | Remarque
+/// info
 
 `status_code` peut aussi recevoir un `IntEnum`, comme le [`http.HTTPStatus`](https://docs.python.org/3/library/http.html#http.HTTPStatus) de Python.
 

docs/fr/docs/tutorial/testing.md

@@ -8,7 +8,7 @@ Avec cela, vous pouvez utiliser [pytest](https://docs.pytest.org/) directement a
 
 ## Utiliser `TestClient` { #using-testclient }
 
-/// note | Remarque
+/// info
 
 Pour utiliser `TestClient`, installez d’abord [`httpx`](https://www.python-httpx.org).
 
@@ -144,7 +144,7 @@ Par exemple :
 
 Pour plus d’informations sur la manière de transmettre des données au backend (en utilisant `httpx` ou le `TestClient`), consultez la [documentation HTTPX](https://www.python-httpx.org).
 
-/// note | Remarque
+/// info
 
 Notez que le `TestClient` reçoit des données qui peuvent être converties en JSON, pas des modèles Pydantic.
 

fastapi/__init__.py

@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.137.0"
+__version__ = "0.137.1"
 
 from starlette import status as status
 

fastapi/routing.py

@@ -1062,6 +1062,41 @@ def _populate_api_route_state(
 
 
 class APIRoute(routing.Route):
+    stream_item_type: Any | None
+    response_model: Any
+    summary: str | None
+    response_description: str
+    deprecated: bool | None
+    operation_id: str | None
+    response_model_include: IncEx | None
+    response_model_exclude: IncEx | None
+    response_model_by_alias: bool
+    response_model_exclude_unset: bool
+    response_model_exclude_defaults: bool
+    response_model_exclude_none: bool
+    include_in_schema: bool
+    response_class: type[Response] | DefaultPlaceholder
+    dependency_overrides_provider: Any | None
+    callbacks: list[BaseRoute] | None
+    openapi_extra: dict[str, Any] | None
+    generate_unique_id_function: Callable[[Any], str] | DefaultPlaceholder
+    strict_content_type: bool | DefaultPlaceholder
+    tags: list[str | Enum]
+    responses: dict[int | str, dict[str, Any]]
+    unique_id: str
+    status_code: int | None
+    response_field: ModelField | None
+    stream_item_field: ModelField | None
+    dependencies: list[params.Depends]
+    description: str
+    response_fields: dict[int | str, ModelField]
+    dependant: Dependant
+    _flat_dependant: Dependant
+    _embed_body_fields: bool
+    body_field: ModelField | None
+    is_sse_stream: bool
+    is_json_stream: bool
+
     def __init__(
         self,
         path: str,
@@ -2435,9 +2470,16 @@ class APIRouter(routing.Router):
                 "A path prefix must not end with '/', as the routes will start with '/'"
             )
         else:
-            for r in _iter_included_route_candidates(router.routes):
-                path = getattr(r, "path", None)
-                name = getattr(r, "name", "unknown")
+            for route, route_context in _iter_routes_with_context(router.routes):
+                if route_context is None:
+                    path = getattr(route, "path", None)
+                    name = getattr(route, "name", "unknown")
+                elif route_context.starlette_route is not None:
+                    path = getattr(route_context.starlette_route, "path", None)
+                    name = getattr(route_context.starlette_route, "name", "unknown")
+                else:
+                    path = route_context.path
+                    name = route_context.name
                 if path is not None and not path:
                     raise FastAPIError(
                         f"Prefix and path cannot be both empty (path operation: {name})"

pyproject.toml

@@ -349,5 +349,41 @@ havin = "havin"
 Ines = "Ines"
 ser = "ser"
 
+[tool.ty.src]
+exclude = [
+    # These docs examples are intentionally partial, dynamic, environment-driven,
+    # deprecated, or currently require broader tutorial rewrites to satisfy ty.
+    "docs_src/additional_status_codes/",
+    "docs_src/app_testing/tutorial003_py310.py",
+    "docs_src/body_multiple_params/",
+    "docs_src/body_updates/tutorial002_py310.py",
+    "docs_src/custom_docs_ui/",
+    "docs_src/custom_response/tutorial001_py310.py",
+    "docs_src/custom_response/tutorial001b_py310.py",
+    "docs_src/custom_response/tutorial009c_py310.py",
+    "docs_src/dependencies/tutorial007_py310.py",
+    "docs_src/dependencies/tutorial008_an_py310.py",
+    "docs_src/dependencies/tutorial008_py310.py",
+    "docs_src/dependencies/tutorial010_py310.py",
+    "docs_src/events/",
+    "docs_src/extending_openapi/tutorial001_py310.py",
+    "docs_src/path_params_numeric_validations/",
+    "docs_src/pydantic_v1_in_v2/tutorial004_an_py310.py",
+    "docs_src/python_types/tutorial003_py310.py",
+    "docs_src/python_types/tutorial011_py310.py",
+    "docs_src/query_params_str_validations/",
+    "docs_src/response_model/tutorial006_py310.py",
+    "docs_src/security/tutorial003_an_py310.py",
+    "docs_src/security/tutorial003_py310.py",
+    "docs_src/security/tutorial004_an_py310.py",
+    "docs_src/security/tutorial004_py310.py",
+    "docs_src/security/tutorial005_an_py310.py",
+    "docs_src/security/tutorial005_py310.py",
+    "docs_src/settings/",
+    "docs_src/sql_databases/",
+    "docs_src/using_request_directly/tutorial001_py310.py",
+    "docs_src/wsgi/tutorial001_py310.py",
+]
+
 [tool.ty.terminal]
 error-on-warning = true

scripts/lint.sh

@@ -4,6 +4,6 @@ set -e
 set -x
 
 mypy fastapi
-ty check fastapi
+ty check fastapi docs_src --force-exclude
 ruff check fastapi tests docs_src scripts
 ruff format fastapi tests --check

tests/test_router_include_context.py

@@ -2,6 +2,7 @@ from typing import Annotated, cast
 
 import pytest
 from fastapi import APIRouter, Body, Depends, FastAPI, Request
+from fastapi.exceptions import FastAPIError
 from fastapi.responses import HTMLResponse, JSONResponse, PlainTextResponse
 from fastapi.routing import (
     APIRoute,
@@ -807,6 +808,60 @@ def test_no_prefix_include_validation_sees_effective_starlette_route_candidates(
     assert cast(Route, candidates[0]).path == "/child/items"
 
 
+def test_no_prefix_include_validation_sees_effective_api_route_path():
+    leaf_router = APIRouter()
+
+    @leaf_router.get("")
+    def read_items():
+        return []
+
+    parent_router = APIRouter()
+    parent_router.include_router(leaf_router, prefix="/items")
+
+    # for coverage
+    candidates = list(_iter_included_route_candidates(parent_router.routes))
+    assert cast(APIRoute, candidates[0]).path == ""
+
+    app = FastAPI()
+    app.include_router(parent_router)
+    client = TestClient(app)
+
+    response = client.get("/items")
+
+    assert response.status_code == 200, response.text
+    assert response.json() == []
+
+
+def test_no_prefix_include_validation_sees_effective_starlette_route_path():
+    def endpoint(request):
+        return PlainTextResponse("ok")
+
+    child_router = APIRouter(routes=[Route("/items", endpoint, name="read_items")])
+    parent_router = APIRouter()
+    parent_router.include_router(child_router, prefix="/child")
+
+    app = FastAPI()
+    app.include_router(parent_router)
+    client = TestClient(app)
+
+    response = client.get("/child/items")
+
+    assert response.status_code == 200, response.text
+    assert response.text == "ok"
+
+
+def test_no_prefix_include_validation_rejects_empty_effective_api_route_path():
+    router = APIRouter()
+
+    @router.get("")
+    def read_items():  # pragma: no cover
+        return []
+
+    app = FastAPI()
+    with pytest.raises(FastAPIError):
+        app.include_router(router)
+
+
 def test_apirouter_matches_fallback_without_include_context():
     router = APIRouter()