From 472506507c212a0eb8b6440ed015a8f2d153fcc6 Mon Sep 17 00:00:00 2001 From: eqsdxr Date: Sat, 22 Feb 2025 18:37:26 +0500 Subject: [PATCH] Enhance docs This behavior is not always obvious, the change makes it explicit. --- docs/en/docs/tutorial/body-updates.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/en/docs/tutorial/body-updates.md b/docs/en/docs/tutorial/body-updates.md index df5b960db..f4ce525c9 100644 --- a/docs/en/docs/tutorial/body-updates.md +++ b/docs/en/docs/tutorial/body-updates.md @@ -64,6 +64,14 @@ Then you can use this to generate a `dict` with only the data that was set (sent {* ../../docs_src/body_updates/tutorial002_py310.py hl[32] *} +/// note + +Notice that setting a value to `null` in a request does not omit the field; it explicitly assigns `null` to a field (which FastAPI converts to `None` in Python) and is not considered "unset." + +To omit a field, simply exclude it from the request payload. + +/// + ### Using Pydantic's `update` parameter Now, you can create a copy of the existing model using `.model_copy()`, and pass the `update` parameter with a `dict` containing the data to update.