diff --git a/docs/java-api/admin/indices/index.asciidoc b/docs/java-api/admin/indices/index.asciidoc
index 83645e6c3c2..bbd365076c7 100644
--- a/docs/java-api/admin/indices/index.asciidoc
+++ b/docs/java-api/admin/indices/index.asciidoc
@@ -15,5 +15,7 @@ include::create-index.asciidoc[]
 
 include::put-mapping.asciidoc[]
 
+include::refresh.asciidoc[]
+
 include::get-settings.asciidoc[]
 include::update-settings.asciidoc[]
diff --git a/docs/java-api/admin/indices/refresh.asciidoc b/docs/java-api/admin/indices/refresh.asciidoc
new file mode 100644
index 00000000000..856c270daf3
--- /dev/null
+++ b/docs/java-api/admin/indices/refresh.asciidoc
@@ -0,0 +1,19 @@
+[[java-admin-indices-refresh]]
+==== Refresh
+
+The refresh API allows to explicitly refresh one or more index:
+
+[source,java]
+--------------------------------------------------
+client.admin().indices().prepareRefresh().get(); <1>
+client.admin().indices()
+        .prepareRefresh("twitter")               <2>
+        .get();
+client.admin().indices()
+        .prepareRefresh("twitter", "company")   <3>
+        .get();
+--------------------------------------------------
+<1> Refresh all indices
+<2> Refresh one index
+<3> Refresh many indices
+