From f0b10d506c4ade4a39ef3723b04efe24df670ef3 Mon Sep 17 00:00:00 2001
From: Elijah Voigt <elijah.caine.mv@gmail.com>
Date: Wed, 4 Mar 2026 13:10:48 -0800
Subject: [PATCH] docs(quotesdb): add /api/status to OpenAPI spec

Add GET /api/status path and StatusResponse schema. The endpoint
returns { "submissions_locked": bool } with 200 or 500, requires
no auth, and is tagged under the existing `meta` group.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 quotesdb/api/openapi.yaml | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/quotesdb/api/openapi.yaml b/quotesdb/api/openapi.yaml
index b4d04fa..9b28061 100644
--- a/quotesdb/api/openapi.yaml
+++ b/quotesdb/api/openapi.yaml
@@ -179,6 +179,17 @@ components:
           type: integer
           description: Total number of quotes matching the current filters.
 
+    # Response body for GET /api/status.
+    StatusResponse:
+      type: object
+      required:
+        - submissions_locked
+      properties:
+        submissions_locked:
+          type: boolean
+          description: Whether new quote submissions are currently disabled.
+          example: false
+
     # Standard error envelope used by all error responses.
     Error:
       type: object
@@ -213,6 +224,29 @@ paths:
                 type: object
                 description: Raw OpenAPI 3.1 document.
 
+  /api/status:
+    get:
+      operationId: getStatus
+      summary: API status
+      description: >
+        Returns the current operational status of the API. Callers can check
+        submissions_locked to determine whether the PUT /api/quotes endpoint
+        is accepting new submissions.
+      tags: [meta]
+      responses:
+        "200":
+          description: Current API status.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/StatusResponse"
+        "500":
+          description: Internal server error.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+
   /api/quotes:
     get:
       operationId: listQuotes