Fix: Make swagger doc compliant to OpenAPI (#3394)

This fixes issues in the swagger.json file. The motivation to do so is to be able to generate API clients using https://openapi-generator.tech Doing so will require further changes to the api spec, but this seems like a good first step since it is now "valid" according to editor.swagger.io and openapi-generator validate.

Fixes #2806

swagger/definitions/resource/conversation.yml

@@ -5,6 +5,8 @@ properties:
     description: ID of the conversation
   messages:
     type: array
+    items:
+      $ref: '#/definitions/message'
   account_id:
     type: number
     description: Account Id
@@ -21,7 +23,7 @@ properties:
   contact_last_seen_at:
     type: string
   agent_last_seen_at:
-    type: agent_last_seen_at
+    type: string
   unread_count:
     type: number
     description: The number of unread messages

swagger/definitions/resource/custom_filter.yml

@@ -14,8 +14,10 @@ properties:
     type: object
     description: A query that needs to be saved as a custom filter
   created_at:
-    type: datetime
+    type: string
+    format: date-time
     description: The time at which the custom filter was created
   updated_at:
-    type: datetime
+    type: string
+    format: date-time
     description: The time at which the custom filter was updated

swagger/definitions/resource/integrations/app.yml

@@ -20,4 +20,6 @@ properties:
     description: Whether multiple hooks can be created for the integration
   hooks:
     type: array
+    items:
+      type: object
     description: If there are any hooks created for this integration

swagger/definitions/resource/public/conversation.yml

@@ -1,5 +1,5 @@
 type: object
-properties: 
+properties:
   id:
     type: integer
     description: Id of the conversation
@@ -8,7 +8,9 @@ properties:
     description: The inbox id of the conversation
   messages:
     type: array
+    items:
+      $ref: '#/definitions/message'
     description: Messages in the conversation
   contact:
     type: object
-    description: The contact information associated to the conversation
+    description: The contact information associated to the conversation

swagger/definitions/resource/public/message.yml

@@ -1,5 +1,5 @@
 type: object
-properties: 
+properties:
   id:
     type: string
     description: Id of the message
@@ -23,6 +23,8 @@ properties:
     description: Conversation Id of the message
   attachments:
     type: array
+    items:
+      type: object
     description: Attachments if any
   sender:
     type: object