diligent-node-api/src/documentation/routesDesc/user/getUserDesc.js

module.exports = {
    get: {
        tags: ["User"],
        description: "Get user by id",
        parameters: [
            {
                name: "id",
                in: "path",
                schema: {
                    $ref: "#/components/schemas/id",
                },
                required: true,
                description: "A single user id",
            }
        ],
        responses: {
            200: {
                description: "Success",
                content: {
                    "application/json": {
                        schema: {
                            $ref: "#/components/schemas/User",
                        }
                    }
                }
            },
            400: {
                description: "Bad request"
            },
            404: {
                description: "User with specified id does not exist"
            },
            500: {
                description: "Internal server error"
            }
        }
    }
}