chore: Swagger documentation for public APIs (#2417)

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

@@ -0,0 +1,20 @@
+tags:
+  - Messages API
+operationId: create-a-message
+summary: Create a message
+description: Create a message
+security:
+  - nil
+parameters:
+  - name: data
+    in: body
+    required: true
+    schema:
+      $ref: '#/definitions/public_message_create_payload'
+responses:
+  200:
+    description: Success
+    schema:
+      $ref: '#/definitions/public_message'
+  401:
+    description: Unauthorized

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

@@ -0,0 +1,15 @@
+tags:
+  - Messages API
+operationId: list-all-converation-messages
+summary: List all messages
+description: List all messages in the conversation
+responses:
+  200:
+    description: Success
+    schema:
+      type: array
+      description: 'Array of messages'
+      items:
+        $ref: '#/definitions/public_message'
+  401:
+    description: Unauthorized

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

@@ -0,0 +1,20 @@
+tags:
+  - Messages API
+operationId: update-a-message
+summary: Update a message
+description: Update a message
+security:
+  - nil
+parameters:
+  - name: data
+    in: body
+    required: true
+    schema:
+      $ref: '#/definitions/public_message_update_payload'
+responses:
+  200:
+    description: Success
+    schema:
+      $ref: '#/definitions/public_message'
+  401:
+    description: Unauthorized