From d5e8480367ec3335a6328f97cbc454e7bb726687 Mon Sep 17 00:00:00 2001
From: Jeremy Stretch <jstretch@netboxlabs.com>
Date: Tue, 7 Oct 2025 11:22:24 -0400
Subject: [PATCH] Update OpenAPI schema (#20519)

---
 contrib/openapi.json | 45 ++++++++++++++++++++++++--------------------
 1 file changed, 25 insertions(+), 20 deletions(-)

diff --git a/contrib/openapi.json b/contrib/openapi.json
index 94cf6d659..33b5092af 100644
--- a/contrib/openapi.json
+++ b/contrib/openapi.json
@@ -214760,7 +214760,7 @@
                     },
                     "mark_utilized": {
                         "type": "boolean",
-                        "description": "Report space as 100% utilized"
+                        "description": "Report space as fully utilized"
                     }
                 },
                 "required": [
@@ -214869,7 +214869,7 @@
                     },
                     "mark_utilized": {
                         "type": "boolean",
-                        "description": "Report space as 100% utilized"
+                        "description": "Report space as fully utilized"
                     }
                 },
                 "required": [
@@ -215569,24 +215569,26 @@
             "IntegerRange": {
                 "type": "array",
                 "items": {
-                    "type": "array",
-                    "items": {
-                        "type": "integer"
-                    },
-                    "minItems": 2,
-                    "maxItems": 2
-                }
+                    "type": "integer"
+                },
+                "minItems": 2,
+                "maxItems": 2,
+                "example": [
+                    10,
+                    20
+                ]
             },
             "IntegerRangeRequest": {
                 "type": "array",
                 "items": {
-                    "type": "array",
-                    "items": {
-                        "type": "integer"
-                    },
-                    "minItems": 2,
-                    "maxItems": 2
-                }
+                    "type": "integer"
+                },
+                "minItems": 2,
+                "maxItems": 2,
+                "example": [
+                    10,
+                    20
+                ]
             },
             "Interface": {
                 "type": "object",
@@ -228986,7 +228988,6 @@
                     },
                     "key": {
                         "type": "string",
-                        "writeOnly": true,
                         "maxLength": 40,
                         "minLength": 40
                     },
@@ -231880,7 +231881,7 @@
                     },
                     "mark_utilized": {
                         "type": "boolean",
-                        "description": "Report space as 100% utilized"
+                        "description": "Report space as fully utilized"
                     }
                 }
             },
@@ -245221,6 +245222,11 @@
                         "format": "date-time",
                         "nullable": true
                     },
+                    "key": {
+                        "type": "string",
+                        "maxLength": 40,
+                        "minLength": 40
+                    },
                     "write_enabled": {
                         "type": "boolean",
                         "description": "Permit create/update/delete operations using this key"
@@ -245367,7 +245373,6 @@
                     },
                     "key": {
                         "type": "string",
-                        "writeOnly": true,
                         "maxLength": 40,
                         "minLength": 40
                     },
@@ -252203,7 +252208,7 @@
                     },
                     "mark_utilized": {
                         "type": "boolean",
-                        "description": "Report space as 100% utilized"
+                        "description": "Report space as fully utilized"
                     }
                 },
                 "required": [