diff --git a/docs/models.yml b/docs/models.yml
index 261030ebf..77153bf03 100644
--- a/docs/models.yml
+++ b/docs/models.yml
@@ -1020,7 +1020,10 @@ topic:
 motion:
   id: number
   number: string
-  number_value: number
+  number_value:
+    type: number
+    description: The number value of this motion. This number is auto-generated and read-only.
+    read_only: true
   sequential_number:
     type: number
     description: The (positive) serial number of this motion. This number is auto-generated and read-only.