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

swagger/paths/application/contacts/conversations.yml

@@ -1,22 +1,43 @@
+parameters:
+  - $ref: '#/components/parameters/account_id'
+  - name: id
+    in: path
+    required: true
+    schema:
+      type: number
+    description: ID of the contact
+
 get:
   tags:
     - Contacts
   operationId: contactConversations
   summary: Contact Conversations
-  description: Get conversations associated to that contact
+  description: Get conversations associated with that contact
   parameters:
-    - $ref: '#/parameters/account_id'
     - name: id
       in: path
-      type: number
-      description: ID of the contact
       required: true
-  responses:
-    200:
-      description: Success
       schema:
-        $ref: '#/definitions/contact_conversations'
-    404:
+        type: number
+      description: ID of the contact
+  security:
+    - userApiKey: []
+  responses:
+    '200':
+      description: Success
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/contact_conversations'
+    '404':
       description: Contact not found
-    403:
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/bad_request_error'
+    '403':
       description: Access denied
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/bad_request_error'