Update API definitions

Author: rebilly-machine-user

openapi/components/responses/BadRequest.yaml

@@ -0,0 +1,5 @@
+description: Server could not understand the request due to invalid syntax.
+content:
+  application/json:
+    schema:
+      $ref: ../schemas/ProblemTypes/BadRequest.yaml

openapi/components/schemas/ProblemTypes/BadRequest.yaml

@@ -0,0 +1,12 @@
+allOf:
+  - title: Bad request
+  - type: object
+    properties:
+      status:
+        type: integer
+        description: HTTP status code.
+        minimum: 400
+        maximum: 400
+      invalidFields:
+        $ref: ./InvalidFields.yaml
+  - $ref: ./BaseProblem.yaml

openapi/components/schemas/ProblemTypes/InvalidFields.yaml

@@ -0,0 +1,20 @@
+type: array
+description: Invalid field details.
+items:
+  type: object
+  properties:
+    field:
+      type: string
+      description: |-
+        Name of the field.
+        Dot notation is used for nested object field names.
+    message:
+      description: Message field.
+      type: string
+example:
+  - field: field1
+    message: field1 is invalid
+  - field: subObject.field2
+    message: field2 is invalid
+  - field: subObject.field2
+    message: another error in the field2

openapi/components/schemas/ProblemTypes/ValidationError.yaml

@@ -11,23 +11,4 @@ allOf:
   - type: object
     properties:
       invalidFields:
-        description: Invalid field details.
-        type: array
-        items:
-          type: object
-          properties:
-            field:
-              type: string
-              description: |-
-                Name of the field.
-                Dot notation is used for nested object field names.
-            message:
-              description: Message field.
-              type: string
-        example:
-          - field: field1
-            message: field1 is invalid
-          - field: subObject.field2
-            message: field2 is invalid
-          - field: subObject.field2
-            message: another error in the field2
+        $ref: ./InvalidFields.yaml

openapi/paths/reports@kyc-acceptance-summary.yaml

@@ -127,6 +127,8 @@ get:
                     manualReviewTime:
                       type: number
                       description: Median duration in minutes between review and created time for manually reviewed documents.
+    '400':
+      $ref: ../components/responses/BadRequest.yaml
     '401':
       $ref: ../components/responses/Unauthorized.yaml
     '403':