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

swagger/paths/application/conversation/custom_attributes.yml

@@ -5,32 +5,41 @@ summary: Update Custom Attributes
 description: Updates the custom attributes of a conversation
 security:
   - userApiKey: []
-  - agentBotApiKey: []
-parameters:
-  - name: data
-    in: body
-    required: true
-    schema:
-      type: object
-      required:
-        - custom_attributes
-      properties:
-        custom_attributes:
-          type: object
-          description: The custom attributes to be set for the conversation
-          example:
-            order_id: "12345"
-            previous_conversation: "67890"
+requestBody:
+  required: true
+  content:
+    application/json:
+      schema:
+        type: object
+        required:
+          - custom_attributes
+        properties:
+          custom_attributes:
+            type: object
+            description: The custom attributes to be set for the conversation
+            example:
+              order_id: '12345'
+              previous_conversation: '67890'
 responses:
-  200:
+  '200':
     description: Success
-    schema:
-      type: object
-      properties:
-        custom_attributes:
+    content:
+      application/json:
+        schema:
           type: object
-          description: The custom attributes of the conversation
-  404:
+          properties:
+            custom_attributes:
+              type: object
+              description: The custom attributes of the conversation
+  '401':
+    description: Unauthorized
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'
+  '404':
     description: Conversation not found
-  401:
-    description: Unauthorized 
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'