Apply suggestions from code review

api-admin/openapi.yaml

@@ -168,15 +168,14 @@ components:
       content:
         application/json:
           schema:
-            $ref: '#/components/schemas/Users'
-          example:
-            - userId: 41190cee-5231-4dcc-8167-ebf798b55ce3
-              name: user-1
-              appIds: [41190cee-5231-4dcc-8167-ebf798b55ce3, 41190cee-5231-4dcc-8167-ebf798b55ce4]
-
-            - userId: 41190cee-5231-55gg-8167-ebf798b55ce3
-              name: user-2
-              appIds: [41190cee-5231-4dcc-8167-ebf798b55ce3, 41190cee-5231-4dcc-8167-ebf798b55ce4]
+            type: object
+            required:
+              - users
+            properties:
+              users:
+                type: array
+                items:
+                  $ref: '#/components/schemas/User'
 
     ApplicationsUsersListFailure:
       description:
@@ -191,11 +190,11 @@ components:
                 description: |
                   Possible errors: <br/>
                   `access_denied` — This error occures when user's session was expired | user doesn't have enough permission | or user unauthorized.<br/>
-                  `invalid_request` — Something was wrong with user request.<br/>
+                  `application_not_found` — No application with provided ID.<br/>
                 type: string
                 enum:
                   - access_denied
-                  - invalid_request
+                  - application_not_found
 
   requestBodies:
     ApplicationsUserAdd:
@@ -264,20 +263,19 @@ components:
                 example: 41190cee-5231-4dcc-8167-ebf798b55ce3
 
   schemas:
-    Users:
-      type: array
-      items:
-        type: object
-        properties:
-          userId:
-            type: string
-            format: uuid
-          name:
-            type: string
-          appIds:
-            type: array
-            items:
-              description: applications id which related to user
-              type: string
-              format: uuid
-              example: 41190cee-5231-4dcc-8167-ebf798b55ce3
+    User:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+        firstName:
+          type: string
+          example: John
+        lastName:
+          type: string
+          example: Doe
+        email:
+          type: string
+          format: email
+          example: [email protected]