Merge pull request #14195 from rubhanazeem/document-status-messages

OpenAPI specifications for GET status/messages

src/api/public/apidocs-new/OBS-v2.10.50.yaml

@@ -395,6 +395,10 @@ paths:
   /worker?cmd=checkconstraints:
     $ref: 'paths/worker_cmd_checkconstraints.yaml'
 
+  # Status messages
+  /status/messages:
+    $ref: 'paths/status_messages.yaml'
+
 components:
   securitySchemes:
     basic_authentication:

src/api/public/apidocs-new/paths/status_messages.yaml

@@ -0,0 +1,32 @@
+get:
+  summary: Get list of status messages
+  description: |
+    Get a list of all status messages
+  security:
+    - basic_authentication: []
+  responses:
+    '200':
+      description: OK. The request has succeeded.
+      content:
+        application/xml; charset=utf-8:
+          schema:
+            $ref: '../components/schemas/status_messages.yaml'
+          example:
+            count: 2
+            status_message:
+              - id: 2
+                message: OBS 3.0 is released!
+                user: Iggy
+                severity: announcement
+                scope: all_users
+                created_at: 2021-10-15 13:28:22 UTC
+              - id: 1
+                message: Feature number 42 was implemented!
+                user: Iggy
+                severity: announcement
+                scope: all_users
+                created_at: 2021-10-12 11:18:12 UTC
+    '401':
+      $ref: '../components/responses/unauthorized.yaml'
+  tags:
+    - Status messages