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

swagger/paths/application/integrations/hooks/update.yml

@@ -3,18 +3,27 @@ tags:
 operationId: update-an-integrations-hook
 summary: Update an Integration Hook
 description: Update an Integration Hook
+security:
+  - userApiKey: []
 parameters:
-  - $ref: '#/parameters/account_id'
-  - $ref: '#/parameters/hook_id'
-  - name: data
-    in: body
-    required: true
-    schema:
-      $ref: '#/definitions/integrations_hook_update_payload'
+  - $ref: '#/components/parameters/account_id'
+  - $ref: '#/components/parameters/hook_id'
+requestBody:
+  required: true
+  content:
+    application/json:
+      schema:
+        $ref: '#/components/schemas/integrations_hook_update_payload'
 responses:
-  200:
+  '200':
     description: Success
-    schema:
-      $ref: '#/definitions/integrations_hook'
-  401:
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/integrations_hook'
+  '401':
     description: Unauthorized
+    content:
+      application/json:
+        schema:
+          $ref: '#/components/schemas/bad_request_error'