diff --git a/web/api/src/main/java/org/onosproject/rest/resources/ApiDocResource.java b/web/api/src/main/java/org/onosproject/rest/resources/ApiDocResource.java
index 0ad4fc6..804f05e 100644
--- a/web/api/src/main/java/org/onosproject/rest/resources/ApiDocResource.java
+++ b/web/api/src/main/java/org/onosproject/rest/resources/ApiDocResource.java
@@ -107,6 +107,8 @@
      * Get Swagger UI main index page.
      *
      * @return 200 OK
+     * @throws IOException if unable to get index resource
+     * @throws URISyntaxException if unable to create redirect URI
      */
     @GET
     @Path("/")
@@ -119,6 +121,7 @@
      * Get Swagger UI main index page.
      *
      * @return 200 OK
+     * @throws IOException if unable to get index resource
      */
     @GET
     @Path("index.html")
@@ -155,7 +158,9 @@
     /**
      * Get Swagger UI resource.
      *
+     * @param resource path of the resource
      * @return 200 OK
+     * @throws IOException if unable to get named resource
      */
     @GET
     @Path("{resource: .*}")
diff --git a/web/api/src/main/java/org/onosproject/rest/resources/ClusterWebResource.java b/web/api/src/main/java/org/onosproject/rest/resources/ClusterWebResource.java
index ee608b7..dd9b9fc 100644
--- a/web/api/src/main/java/org/onosproject/rest/resources/ClusterWebResource.java
+++ b/web/api/src/main/java/org/onosproject/rest/resources/ClusterWebResource.java
@@ -77,6 +77,7 @@
      *
      * @param config cluster definition
      * @return 200 OK
+     * @throws IOException to signify bad request
      */
     @POST
     @Path("configuration")
diff --git a/web/api/src/main/java/org/onosproject/rest/resources/ComponentConfigWebResource.java b/web/api/src/main/java/org/onosproject/rest/resources/ComponentConfigWebResource.java
index 4adb6c5..468a376 100644
--- a/web/api/src/main/java/org/onosproject/rest/resources/ComponentConfigWebResource.java
+++ b/web/api/src/main/java/org/onosproject/rest/resources/ComponentConfigWebResource.java
@@ -82,7 +82,9 @@
      * Sets only the properties present in the JSON request.
      *
      * @param component component name
+     * @param request   JSON configuration
      * @return 200 OK
+     * @throws IOException to signify bad request
      */
     @POST
     @Path("{component}")
@@ -100,7 +102,9 @@
      * Clears only the properties present in the JSON request.
      *
      * @param component component name
+     * @param request   JSON configuration
      * @return 200 OK
+     * @throws IOException to signify bad request
      */
     @DELETE
     @Path("{component}")