chore: Swagger doc for Conversation meta API (#4394)

fixes: https://github.com/chatwoot/chatwoot/issues/4327

swagger/paths/application/conversation/index.yml

@@ -12,17 +12,22 @@ get:
       in: query
       type: string
       enum: ['me', 'unassigned', 'all', 'assigned']
-      required: true
+      default: 'all'
+      description: Filter conversations by assignee type.
     - name: status
       in: query
       type: string
-      enum: ['open', 'resolved', 'pending']
-      required: true
-    - name: page
+      enum: ['open', 'resolved', 'pending', 'snoozed']
+      default: 'open'
+      description: Filter by conversation status.
+    - name: q
+      in: query
+      type: string
+      description: Filters conversations with messages containing the search term
+    - name: inbox_id
       in: query
       type: integer
-      required: true
-    - name: inbox_id
+    - name: team_id
       in: query
       type: integer
     - name: labels
@@ -30,7 +35,12 @@ get:
       type: array
       items:
         type: string
-
+    - name: page
+      in: query
+      type: integer
+      default: 1
+      description: paginate through conversations
+   
   responses:
     200:
       description: Success

swagger/paths/application/conversation/meta.yml

@@ -0,0 +1,53 @@
+parameters:
+  - $ref: '#/parameters/account_id'
+
+get:
+  tags:
+    - Conversations
+  operationId: conversationListMeta
+  description: Get open, unassigned and all Conversation counts
+  summary: Get Conversation Counts
+  parameters:
+    - name: status
+      in: query
+      type: string
+      enum: ['open', 'resolved', 'pending', 'snoozed']
+      default: 'open'
+      description: Filter by conversation status.
+    - name: q
+      in: query
+      type: string
+      description: Filters conversations with messages containing the search term
+    - name: inbox_id
+      in: query
+      type: integer
+    - name: team_id
+      in: query
+      type: integer
+    - name: labels
+      in: query
+      type: array
+      items:
+        type: string
+
+  responses:
+    200:
+      description: Success
+      schema:
+        type: object
+        properties:
+          meta:
+            type: object
+            properties:
+              mine_count:
+                type: number
+              unassigned_count:
+                type: number
+              assigned_count:
+                type: number
+              all_count:
+                type: number
+    400:
+      description: Bad Request Error
+      schema:
+        $ref: '#/definitions/bad_request_error'