From b7b14cc84da3240fb33f6e3135c32fcd18fc878b Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 10 Apr 2026 18:30:59 +0000
Subject: [PATCH] docs: fix OpenAPI spec schema discrepancies

- Fix /admin/ws-auth method from POST to GET (matches actual handler)
- Fix /admin/ws-auth summary from "Test source database" to
  "WebSocket authentication"
- Add missing dbName field to Database schema
- Add missing branch and revision fields to Clone schema
- Add missing extra_conf field to CreateClone schema

https://claude.ai/code/session_011sPDgBjzL2N2X6jiYyoTjQ
---
 engine/api/swagger-spec/dblab_openapi.yaml | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/engine/api/swagger-spec/dblab_openapi.yaml b/engine/api/swagger-spec/dblab_openapi.yaml
index d5770cf0..0086b6c0 100644
--- a/engine/api/swagger-spec/dblab_openapi.yaml
+++ b/engine/api/swagger-spec/dblab_openapi.yaml
@@ -1219,11 +1219,11 @@ paths:
                 message: "Check your verification token."
       x-codegen-request-body-name: body
   /admin/ws-auth:
-    post:
+    get:
       tags:
       - Admin
-      summary: Test source database
-      operationId: testDBConnection2
+      summary: WebSocket authentication
+      operationId: wsAuth
       parameters:
       - name: Verification-Token
         in: header
@@ -1645,6 +1645,8 @@ components:
           type: string
         password:
           type: string
+        dbName:
+          type: string
     Clone:
       type: object
       properties:
@@ -1654,6 +1656,10 @@ components:
           type: string
         snapshot:
           $ref: '#/components/schemas/Snapshot'
+        branch:
+          type: string
+        revision:
+          type: integer
         protected:
           type: boolean
           default: false
@@ -1730,6 +1736,11 @@ components:
               default:
             db_name:
               type: string
+        extra_conf:
+          type: object
+          additionalProperties:
+            type: string
+          description: Extra PostgreSQL configuration parameters for the clone
     ResetClone:
       type: object
       properties: