Update swag-api-new.yml

swag-api-new.yml

@@ -453,34 +453,6 @@ paths:
       operationId: sendInviteLink
       summary: Send  Invite Link
   /api/1/privileges:
-    get:
-      produces:
-        - application/json
-      parameters: []
-      responses:
-        '200':
-          description: Successful response
-          schema:
-            items:
-              $ref: '#/definitions/privilege'
-            type: array
-        '401':
-          description: Unauthorized
-          examples:
-            application/json:
-              message: This request requires Authentication
-              name: UnauthorizedError
-              statusCode: 401
-          schema:
-            $ref: '#/definitions/altErr'
-      security:
-        - OAuth2:
-            - Manage All
-      tags:
-        - Privileges
-      description: List Privileges
-      operationId: listPriveleges
-      summary: List Privileges
     post:
       consumes:
         - application/json
@@ -529,8 +501,36 @@ paths:
       description: Create privilege
       operationId: createPrivilege
       summary: Create a Privilege
+    get:
+      produces:
+        - application/json
+      parameters: []
+      responses:
+        '200':
+          description: Successful response
+          schema:
+            items:
+              $ref: '#/definitions/privilege'
+            type: array
+        '401':
+          description: Unauthorized
+          examples:
+            application/json:
+              message: This request requires Authentication
+              name: UnauthorizedError
+              statusCode: 401
+          schema:
+            $ref: '#/definitions/altErr'
+      security:
+        - OAuth2:
+            - Manage All
+      tags:
+        - Privileges
+      description: List Privileges
+      operationId: listPriveleges
+      summary: List Privileges
   '/api/1/privileges/{privilege_id}':
-    delete:
+    get:
       produces:
         - application/json
       parameters:
@@ -539,8 +539,10 @@ paths:
           required: true
           type: string
       responses:
-        '204':
-          description: No Content
+        '200':
+          description: Successful response
+          schema:
+            $ref: '#/definitions/privilege'
         '401':
           description: Unauthorized
           examples:
@@ -566,10 +568,10 @@ paths:
             - Manage All
       tags:
         - Privileges
-      description: Delete
-      operationId: deletePrivilege
-      summary: Delete a Privilege
-    get:
+      description: Get a Privilige
+      operationId: getPrivilege
+      summary: Get a Privilege
+    delete:
       produces:
         - application/json
       parameters:
@@ -578,10 +580,8 @@ paths:
           required: true
           type: string
       responses:
-        '200':
-          description: Successful response
-          schema:
-            $ref: '#/definitions/privilege'
+        '204':
+          description: No Content
         '401':
           description: Unauthorized
           examples:
@@ -607,9 +607,9 @@ paths:
             - Manage All
       tags:
         - Privileges
-      description: Get a Privilige
-      operationId: getPrivilege
-      summary: Get a Privilege
+      description: Delete
+      operationId: deletePrivilege
+      summary: Delete a Privilege
     put:
       consumes:
         - application/json
@@ -8579,6 +8579,70 @@ paths:
       operationId: verFactorSaml2
       summary: Verify Factor SAML
   /api/2/users:
+    post:
+      consumes:
+        - application/json
+      produces:
+        - application/json
+      parameters:
+        - description: >-
+            Controls how mappings will be applied to the user on creation.
+            Defaults to async.
+          enum:
+            - async
+            - sync
+            - disabled
+          in: query
+          name: mappings
+          type: string
+        - description: Will passwords validate against the User Policy? Defaults to true.
+          in: query
+          name: validate_policy
+          type: boolean
+        - in: body
+          name: body
+          schema:
+            $ref: '#/definitions/user'
+      responses:
+        '201':
+          description: The full user resource is returned
+          schema:
+            $ref: '#/definitions/user'
+        '400':
+          description: Bad Request
+          examples:
+            application/json:
+              code: 400
+              error: true
+              message: Request Failure
+              type: bad request
+          schema:
+            $ref: '#/definitions/Error'
+        '401':
+          description: Unauthorized
+          examples:
+            application/json:
+              code: 401
+              error: true
+              message: Unauthorized Error
+              type: Unauthorized
+          schema:
+            $ref: '#/definitions/Error'
+        '422':
+          description: Unprocessable
+          examples:
+            application/json:
+              code: 422
+              error: true
+              message: 'Validation failed: Value has already been taken'
+              type: UnprocessableEntityError
+          schema:
+            $ref: '#/definitions/Error'
+      tags:
+        - Users V2
+      description: Create User
+      operationId: createUser2
+      summary: Create User
     get:
       produces:
         - application/json
@@ -8728,33 +8792,19 @@ paths:
       description: Get a list of users
       operationId: listUsers2
       summary: List Users
-    post:
-      consumes:
-        - application/json
+  '/api/2/users/{user_id}':
+    get:
       produces:
         - application/json
       parameters:
-        - description: >-
-            Controls how mappings will be applied to the user on creation.
-            Defaults to async.
-          enum:
-            - async
-            - sync
-            - disabled
-          in: query
-          name: mappings
-          type: string
-        - description: Will passwords validate against the User Policy? Defaults to true.
-          in: query
-          name: validate_policy
-          type: boolean
-        - in: body
-          name: body
-          schema:
-            $ref: '#/definitions/user'
+        - description: Set to the id of the user that you want to return.
+          in: path
+          name: user_id
+          required: true
+          type: integer
       responses:
-        '201':
-          description: The full user resource is returned
+        '200':
+          description: OK
           schema:
             $ref: '#/definitions/user'
         '400':
@@ -8767,32 +8817,27 @@ paths:
               type: bad request
           schema:
             $ref: '#/definitions/Error'
-        '401':
-          description: Unauthorized
-          examples:
-            application/json:
-              code: 401
-              error: true
-              message: Unauthorized Error
-              type: Unauthorized
-          schema:
-            $ref: '#/definitions/Error'
-        '422':
-          description: Unprocessable
+        '404':
+          description: Not Found
           examples:
             application/json:
-              code: 422
+              code: 404
               error: true
-              message: 'Validation failed: Value has already been taken'
-              type: UnprocessableEntityError
+              message: No Route Exists
+              type: Not Found
           schema:
             $ref: '#/definitions/Error'
+      security:
+        - OAuth2:
+            - Manage users
+            - Manage All
+            - Read All
+            - Read Users
       tags:
         - Users V2
-      description: Create User
-      operationId: createUser2
-      summary: Create User
-  '/api/2/users/{user_id}':
+      description: Get User
+      operationId: getUser2
+      summary: Get User
     delete:
       produces:
         - application/json
@@ -8834,51 +8879,7 @@ paths:
       description: Delete User
       operationId: deleteUser2
       summary: Delete User
-    get:
-      produces:
-        - application/json
-      parameters:
-        - description: Set to the id of the user that you want to return.
-          in: path
-          name: user_id
-          required: true
-          type: integer
-      responses:
-        '200':
-          description: OK
-          schema:
-            $ref: '#/definitions/user'
-        '400':
-          description: Bad Request
-          examples:
-            application/json:
-              code: 400
-              error: true
-              message: Request Failure
-              type: bad request
-          schema:
-            $ref: '#/definitions/Error'
-        '404':
-          description: Not Found
-          examples:
-            application/json:
-              code: 404
-              error: true
-              message: No Route Exists
-              type: Not Found
-          schema:
-            $ref: '#/definitions/Error'
-      security:
-        - OAuth2:
-            - Manage users
-            - Manage All
-            - Read All
-            - Read Users
-      tags:
-        - Users V2
-      description: Get User
-      operationId: getUser2
-      summary: Get User
+
     put:
       consumes:
         - application/json