diff --git a/scm-webapp/src/main/java/sonia/scm/api/rest/resources/CipherResource.java b/scm-webapp/src/main/java/sonia/scm/api/rest/resources/CipherResource.java
index d72c9ea6aa..27de46ce03 100644
--- a/scm-webapp/src/main/java/sonia/scm/api/rest/resources/CipherResource.java
+++ b/scm-webapp/src/main/java/sonia/scm/api/rest/resources/CipherResource.java
@@ -49,6 +49,7 @@ import javax.ws.rs.Produces;
 import javax.ws.rs.core.MediaType;
 
 /**
+ * Rest resource to encrypt values.
  *
  * @author Sebastian Sdorra
  * @since 1.41
@@ -58,12 +59,17 @@ public class CipherResource
 {
 
   /**
-   * Method description
+   * Encrypts the request body and returns an encrypted string. This method can
+   * only executed with administration privileges.<br />
+   * <br />
+   * <ul>
+   *   <li>200 success</li>
+   *   <li>500 internal server error</li>
+   * </ul>
    *
+   * @param value value to encrypt
    *
-   * @param value
-   *
-   * @return
+   * @return unique key
    */
   @POST
   @Path("encrypt")
diff --git a/scm-webapp/src/main/java/sonia/scm/api/rest/resources/KeyResource.java b/scm-webapp/src/main/java/sonia/scm/api/rest/resources/KeyResource.java
index 91f2214cd2..619a8e9a2a 100644
--- a/scm-webapp/src/main/java/sonia/scm/api/rest/resources/KeyResource.java
+++ b/scm-webapp/src/main/java/sonia/scm/api/rest/resources/KeyResource.java
@@ -48,6 +48,7 @@ import javax.ws.rs.Produces;
 import javax.ws.rs.core.MediaType;
 
 /**
+ * Rest resource to generate unique keys.
  *
  * @author Sebastian Sdorra
  * @since 1.41
@@ -57,10 +58,10 @@ public class KeyResource
 {
 
   /**
-   * Constructs ...
+   * Constructs a new KeyResource.
    *
    *
-   * @param keyGenerator
+   * @param keyGenerator key generator
    */
   @Inject
   public KeyResource(KeyGenerator keyGenerator)
@@ -71,10 +72,15 @@ public class KeyResource
   //~--- methods --------------------------------------------------------------
 
   /**
-   * Method description
+   * Generates a unique key. This method can only executed with administration 
+   * privileges.<br />
+   * <br />
+   * <ul>
+   *   <li>200 success</li>
+   *   <li>500 internal server error</li>
+   * </ul>
    *
-   *
-   * @return
+   * @return unique key
    */
   @GET
   @Produces(MediaType.TEXT_PLAIN)