Reset password for a User endpoint added to API generation

Author: NickOvt

lib/api/users.js

@@ -2130,15 +2130,41 @@ module.exports = (db, server, userHandler, settingsHandler) => {
     );
 
     server.post(
-        '/users/:user/password/reset',
+        {
+            path: '/users/:user/password/reset',
+            summary: 'Reset password for a User',
+            description: 'This method generates a new temporary password for a User. Additionally it removes all two-factor authentication settings',
+            tags: ['Users'],
+            validationObjs: {
+                requestBody: {
+                    validAfter: Joi.date().empty('').allow(false).description('Allow using the generated password not earlier than provided time'),
+                    sess: sessSchema,
+                    ip: sessIPSchema
+                },
+                queryParams: {},
+                pathParams: {
+                    user: userId
+                },
+                response: {
+                    200: {
+                        description: 'Success',
+                        model: Joi.object({
+                            success: successRes,
+                            password: Joi.string().required().description('Temporary password')
+                        })
+                    }
+                }
+            }
+        },
         tools.responseWrapper(async (req, res) => {
             res.charSet('utf-8');
 
-            const schema = Joi.object().keys({
-                user: Joi.string().hex().lowercase().length(24).required(),
-                validAfter: Joi.date().empty('').allow(false),
-                sess: sessSchema,
-                ip: sessIPSchema
+            const { pathParams, requestBody, queryParams } = req.route.spec.validationObjs;
+
+            const schema = Joi.object({
+                ...pathParams,
+                ...requestBody,
+                ...queryParams
             });
 
             const result = schema.validate(req.params, {