diff --git a/specs/openapi.json b/specs/openapi.json
index d2f5b5f..c6866eb 100644
--- a/specs/openapi.json
+++ b/specs/openapi.json
@@ -24802,6 +24802,12 @@
               }
             ]
           },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
           "flags": {
             "oneOf": [
               {
@@ -24997,6 +25003,12 @@
               }
             ]
           },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
           "flags": {
             "oneOf": [
               {
@@ -28092,6 +28104,13 @@
               "boolean",
               "null"
             ]
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 4096
           }
         }
       },
@@ -28158,6 +28177,13 @@
               "boolean",
               "null"
             ]
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 4096
           }
         }
       },
@@ -28204,6 +28230,13 @@
               "boolean",
               "null"
             ]
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 4096
           }
         }
       },
diff --git a/specs/openapi_preview.json b/specs/openapi_preview.json
index 119d3be..24dd40f 100644
--- a/specs/openapi_preview.json
+++ b/specs/openapi_preview.json
@@ -24887,6 +24887,12 @@
               }
             ]
           },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
           "flags": {
             "oneOf": [
               {
@@ -25082,6 +25088,12 @@
               }
             ]
           },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
           "flags": {
             "oneOf": [
               {
@@ -28470,6 +28482,13 @@
               "boolean",
               "null"
             ]
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 4096
           }
         }
       },
@@ -28536,6 +28555,13 @@
               "boolean",
               "null"
             ]
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 4096
           }
         }
       },
@@ -28582,6 +28608,13 @@
               "boolean",
               "null"
             ]
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "maxLength": 4096
           }
         }
       },