diff --git a/changelogs/internal/newsfragments/1940.clarification b/changelogs/internal/newsfragments/1940.clarification
new file mode 100644
index 000000000..d622ed7f9
--- /dev/null
+++ b/changelogs/internal/newsfragments/1940.clarification
@@ -0,0 +1 @@
+Add the deprecated field to properties of OpenAPI definitions and JSON Schemas.