diff --git a/integration/admin-client/src/main/java/org/keycloak/admin/client/resource/UserStorageProviderResource.java b/integration/admin-client/src/main/java/org/keycloak/admin/client/resource/UserStorageProviderResource.java
index 974e6e33d0..4885f87f86 100644
--- a/integration/admin-client/src/main/java/org/keycloak/admin/client/resource/UserStorageProviderResource.java
+++ b/integration/admin-client/src/main/java/org/keycloak/admin/client/resource/UserStorageProviderResource.java
@@ -30,11 +30,32 @@ import javax.ws.rs.core.MediaType;
  * @version $Revision: 1 $
  */
 public interface UserStorageProviderResource {
+    /**
+     * If the provider supports synchronization, this will invoke it.
+     *
+     * Action can be "triggerFullSync" or "triggerChangedUsersSync"
+     *
+     *
+     * @param action
+     * @return
+     */
     @POST
     @Path("{componentId}/sync")
     @Produces(MediaType.APPLICATION_JSON)
     SynchronizationResultRepresentation syncUsers(@QueryParam("action") String action);
 
+    /**
+     * REST invocation for initiating sync for an ldap mapper.  This method may be moved in the future.  Right now
+     * don't have a good place for it.
+     *
+     * direction is "fedToKeycloak" or "keycloakToFed"
+     *
+     *
+     * @param componentId
+     * @param mapperId
+     * @param direction
+     * @return
+     */
     @POST
     @Path("{componentId}/mappers/{mapperId}/sync")
     @Produces(MediaType.APPLICATION_JSON)
diff --git a/services/src/main/java/org/keycloak/services/resources/admin/UserStorageProviderResource.java b/services/src/main/java/org/keycloak/services/resources/admin/UserStorageProviderResource.java
index 6476dce931..5deaf32226 100644
--- a/services/src/main/java/org/keycloak/services/resources/admin/UserStorageProviderResource.java
+++ b/services/src/main/java/org/keycloak/services/resources/admin/UserStorageProviderResource.java
@@ -80,9 +80,13 @@ public class UserStorageProviderResource {
         auth.init(RealmAuth.Resource.USER);
     }
 
-   /**
+    /**
      * Trigger sync of users
      *
+     * Action can be "triggerFullSync" or "triggerChangedUsersSync"
+     *
+     * @param id
+     * @param action
      * @return
      */
     @POST
@@ -128,6 +132,8 @@ public class UserStorageProviderResource {
     /**
      * Trigger sync of mapper data related to ldap mapper (roles, groups, ...)
      *
+     * direction is "fedToKeycloak" or "keycloakToFed"
+     *
      * @return
      */
     @POST