feat: Update swagger to openapi 3.0.4, update request payloads with examples (#11374)

swagger/paths/public/inboxes/messages/create.yml

@@ -4,16 +4,22 @@ operationId: create-a-message
 summary: Create a message
 description: Create a message
 security: []
-parameters:
-  - name: data
-    in: body
-    required: true
-    schema:
-      $ref: '#/definitions/public_message_create_payload'
+requestBody:
+  required: true
+  content:
+    application/json:
+      schema:
+        $ref: '#/components/schemas/public_message_create_payload'
 responses:
-  200:
+  '200':
     description: Success
-    schema:
-      $ref: '#/definitions/public_message'
-  401:
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/public_message'
+  '401':
     description: Unauthorized
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'

swagger/paths/public/inboxes/messages/index.yml

@@ -3,13 +3,20 @@ tags:
 operationId: list-all-converation-messages
 summary: List all messages
 description: List all messages in the conversation
+security: []
 responses:
-  200:
+  '200':
     description: Success
-    schema:
-      type: array
-      description: 'Array of messages'
-      items:
-        $ref: '#/definitions/public_message'
-  401:
+    content:
+      application/json:
+        schema:
+          type: array
+          description: 'Array of messages'
+          items:
+            $ref: '#/components/schemas/public_message'
+  '401':
     description: Unauthorized
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'

swagger/paths/public/inboxes/messages/update.yml

@@ -4,16 +4,22 @@ operationId: update-a-message
 summary: Update a message
 description: Update a message
 security: []
-parameters:
-  - name: data
-    in: body
-    required: true
-    schema:
-      $ref: '#/definitions/public_message_update_payload'
+requestBody:
+  required: true
+  content:
+    application/json:
+      schema:
+        $ref: '#/components/schemas/public_message_update_payload'
 responses:
-  200:
+  '200':
     description: Success
-    schema:
-      $ref: '#/definitions/public_message'
-  401:
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/public_message'
+  '401':
     description: Unauthorized
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'