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

swagger/paths/application/conversation/assignments.yml

@@ -1,30 +1,42 @@
 tags:
-  - Conversation Assignment
+  - Conversations
 operationId: assign-a-conversation
 summary: Assign Conversation
 description: Assign a conversation to an agent or a team
 security:
   - userApiKey: []
   - agentBotApiKey: []
-parameters:
-  - name: data
-    in: body
-    required: true
-    schema:
-      type: object
-      properties:
-        assignee_id:
-          type: number
-          description: Id of the assignee user
-        team_id:
-          type: number
-          description: Id of the team. If the assignee_id is present, this param would be ignored
+requestBody:
+  required: true
+  content:
+    application/json:
+      schema:
+        type: object
+        properties:
+          assignee_id:
+            type: number
+            description: Id of the assignee user
+            example: 1
+          team_id:
+            type: number
+            description: Id of the team. If the assignee_id is present, this param would be ignored
+            example: 1
 responses:
-  200:
+  '200':
     description: Success
-    schema:
-      $ref: '#/definitions/user'
-  404:
-    description: Conversation not found
-  401:
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/user'
+  '401':
     description: Unauthorized
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'
+  '404':
+    description: Conversation not found
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'