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

swagger/paths/application/inboxes/create.yml

@@ -4,48 +4,32 @@ post:
   operationId: inboxCreation
   summary: Create an inbox
   description: You can create more than one website inbox in each account
+  security:
+    - userApiKey: []
   parameters:
-    - $ref: '#/parameters/account_id'
-    - name: data
-      in: body
-      required: true
-      schema:
-        type: object
-        properties:
-          name:
-            type: string
-            description: The name of the inbox
-          avatar:
-            type: string
-            format: binary
-            description: File for avatar image
-          channel:
-            type: object
-            properties:
-              type:
-                type: string
-                enum: ['web_widget']
-              website_url:
-                type: string
-                description: URL at which the widget will be loaded
-              welcome_title:
-                type: string
-                description: Welcome title to be displayed on the widget
-              welcome_tagline:
-                type: string
-                description: Welcome tagline to be displayed on the widget
-              agent_away_message:
-                type: string
-                description: A message which will be sent if there is not agent available. This is not available if agentbot is connected
-              widget_color:
-                type: string
-                description: A Hex-color string used to customize the widget
+    - $ref: '#/components/parameters/account_id'
+  requestBody:
+    required: true
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/inbox_create_payload'
   responses:
-    200:
+    '200':
       description: Success
-      schema:
-        $ref: '#/definitions/inbox'
-    404:
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/inbox'
+    '404':
       description: Inbox 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'