Tag untagged endpoints (/metrics, /envs) as Others so they appear in the correct section

Author: beran-t

openapi-public.yml

@@ -1737,6 +1737,42 @@ paths:
       - Others
     servers:
     - *id005
+  /metrics:
+    get:
+      summary: Get the stats of the service
+      security:
+      - *id004
+      responses:
+        '200':
+          description: The resource usage metrics of the service
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Metrics'
+        '502': *id003
+      operationId: getMetrics
+      tags:
+      - Others
+    servers:
+    - *id005
+  /envs:
+    get:
+      summary: Get the environment variables
+      security:
+      - *id004
+      responses:
+        '200':
+          description: Environment variables
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/EnvVars'
+        '502': *id003
+      operationId: getEnvVars
+      tags:
+      - Others
+    servers:
+    - *id005
   /files:
     get:
       summary: Download a file
@@ -1791,38 +1827,6 @@ paths:
       operationId: uploadFile
     servers:
     - *id005
-  /metrics:
-    get:
-      summary: Get the stats of the service
-      security:
-      - *id004
-      responses:
-        '200':
-          description: The resource usage metrics of the service
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/Metrics'
-        '502': *id003
-      operationId: getMetrics
-    servers:
-    - *id005
-  /envs:
-    get:
-      summary: Get the environment variables
-      security:
-      - *id004
-      responses:
-        '200':
-          description: Environment variables
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/EnvVars'
-        '502': *id003
-      operationId: getEnvVars
-    servers:
-    - *id005
 components:
   securitySchemes:
     AccessTokenAuth:

scripts/generate_openapi_reference.py

@@ -1241,13 +1241,16 @@ def rename_and_reorder_tags(spec: dict[str, Any]) -> None:
     }
     TAG_ORDER = ["Sandboxes", "Templates", "Filesystem", "Process", "Tags", "Teams", "Others"]
 
-    # Rename tags on all operations
+    # Rename tags on all operations; tag untagged ones as "Others"
     for path_item in spec.get("paths", {}).values():
         for method in ("get", "post", "put", "patch", "delete", "head", "options"):
             op = path_item.get(method)
-            if not op or "tags" not in op:
+            if not op:
                 continue
-            op["tags"] = [TAG_RENAME.get(t, t) for t in op["tags"]]
+            if "tags" not in op:
+                op["tags"] = ["Others"]
+            else:
+                op["tags"] = [TAG_RENAME.get(t, t) for t in op["tags"]]
 
     # Rebuild the top-level tags list in the desired order
     spec["tags"] = [{"name": t} for t in TAG_ORDER]