Update docs and error message for sudo route

app/api/views/sudo.py

@@ -17,9 +17,9 @@ def enter_sudo():
     user = g.user
     data = request.get_json() or {}
     if "password" not in data:
-        return jsonify(error="Invalid request"), 403
+        return jsonify(error="Invalid password"), 403
     if not user.check_password(data["password"]):
-        return jsonify(error="Invalid request"), 403
+        return jsonify(error="Invalid password"), 403
 
     g.api_key.sudo_mode_at = arrow.now()
     Session.commit()

docs/api.md

@@ -229,11 +229,19 @@ Enable sudo mode
 
 Input:
 
+- `Authentication` header that contains the api key
 - password: User password to validate the user presence and enter sudo mode
 
+```json
+{
+  "password": "yourpassword",
+}
+```
+
 Output: 
 
-- ok: True if sudo mode has been enabled
+- 200 with ```{"ok": true}``` if sudo mode has been enabled.
+- 403 with ```{"error": "Some error"} ``` if there's an error
 
 #### POST /api/api_key