diff --git a/docs/requirements.txt b/docs/requirements.txt
index 36ee44911..961caaa82 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,4 +1,4 @@
 autoapi==2.0.1
 sphinx==8.2.3
-sphinx-autodoc-typehints==2.5.0
+sphinx-autodoc-typehints==3.1.0
 sphinx_rtd_theme==3.0.2
diff --git a/setup.cfg b/setup.cfg
index a197e83a0..5dfb3fb25 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -70,5 +70,5 @@ dev =
     wheel~=0.45.1
 doc =
     autoapi~=2.0.1
-    sphinx-autodoc-typehints~=2.5.0
+    sphinx-autodoc-typehints~=3.1.0
     sphinx-rtd-theme~=3.0.2