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

swagger/paths/application/contactable_inboxes/get.yml

@@ -4,21 +4,32 @@ get:
   operationId: contactableInboxesGet
   description: Get List of contactable Inboxes
   summary: Get Contactable Inboxes
+  security:
+    - userApiKey: []
   parameters:
-    - $ref: '#/parameters/account_id'
+    - $ref: '#/components/parameters/account_id'
     - name: id
       in: path
-      type: number
+      schema:
+        type: number
       description: ID of the contact
       required: true
   responses:
-    200:
+    '200':
       description: Success
-      schema:
-        $ref: '#/definitions/contactable_inboxes'
-    401:
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/contactable_inboxes'
+    '401':
       description: Authentication error
-      schema:
-        $ref: '#/definitions/bad_request_error'
-    422:
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/bad_request_error'
+    '422':
       description: Incorrect payload
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/bad_request_error'