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

swagger/paths/application/contacts/search.yml

@@ -4,23 +4,30 @@ get:
   operationId: contactSearch
   description: Search the resolved contacts using a search key, currently supports email search (Page size = 15). Resolved contacts are the ones with a value for identifier, email or phone number
   summary: Search Contacts
+  security:
+    - userApiKey: []
   parameters:
-    - $ref: '#/parameters/account_id'
+    - $ref: '#/components/parameters/account_id'
     - name: q
       in: query
-      type: string
+      schema:
+        type: string
       description: Search using contact `name`, `identifier`, `email` or `phone number`
-    - $ref: '#/parameters/contact_sort_param'
-    - $ref: '#/parameters/page'
+    - $ref: '#/components/parameters/contact_sort_param'
+    - $ref: '#/components/parameters/page'
   responses:
-    200:
+    '200':
       description: Success
-      schema:
-        type: object
-        properties:
-          payload:
-            $ref: '#/definitions/contact_list'
-    401:
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              payload:
+                $ref: '#/components/schemas/contact_list'
+    '401':
       description: Authentication error
-      schema:
-        $ref: '#/definitions/bad_request_error'
+      content:
+        application/json:
+          schema:
+            $ref: '#/components/schemas/bad_request_error'