From: Jom Karlo Verzosa <jomkarlov@gmail.com>
Date: Sun, 31 Aug 2025 10:58:56 +0000 (+0800)
Subject: 📝 Add deprecation info block about `dict()` in `docs/tutorial/body.md` (#13906)
X-Git-Tag: 0.116.2~34
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=4584f706bdf833ede7e6d5771c0d16bb9c01fafd;p=thirdparty%2Ffastapi%2Ffastapi.git

📝 Add deprecation info block about `dict()` in `docs/tutorial/body.md` (#13906)

Co-authored-by: Sebastián Ramírez <tiangolo@gmail.com>
---

diff --git a/docs/en/docs/tutorial/body.md b/docs/en/docs/tutorial/body.md
index 58e20f4c96..a820802f74 100644
--- a/docs/en/docs/tutorial/body.md
+++ b/docs/en/docs/tutorial/body.md
@@ -128,6 +128,14 @@ Inside of the function, you can access all the attributes of the model object di
 
 {* ../../docs_src/body/tutorial002_py310.py *}
 
+/// info
+
+In Pydantic v1 the method was called `.dict()`, it was deprecated (but still supported) in Pydantic v2, and renamed to `.model_dump()`.
+
+The examples here use `.dict()` for compatibility with Pydantic v1, but you should use `.model_dump()` instead if you can use Pydantic v2.
+
+///
+
 ## Request body + path parameters { #request-body-path-parameters }
 
 You can declare path parameters and request body at the same time.