diff --git a/client/rest/src/main/java/org/opensearch/client/RestClient.java b/client/rest/src/main/java/org/opensearch/client/RestClient.java
index 476156841fa00..45b972f6a883d 100644
--- a/client/rest/src/main/java/org/opensearch/client/RestClient.java
+++ b/client/rest/src/main/java/org/opensearch/client/RestClient.java
@@ -136,7 +136,11 @@
  * Requests can be either synchronous or asynchronous. The asynchronous variants all end with {@code Async}.
  * <p>
  * Requests can be traced by enabling trace logging for "tracer". The trace logger outputs requests and responses in curl format.
+ *
+ * @deprecated the {@code RestClient} is deprecated is going to be removed in future releases, please consider using official
+ * OpenSearch Java Client or {@code RestHighLevelClient}
  */
+@Deprecated
 public class RestClient implements Closeable {
 
     private static final Log logger = LogFactory.getLog(RestClient.class);
diff --git a/client/rest/src/main/java/org/opensearch/client/RestClientBuilder.java b/client/rest/src/main/java/org/opensearch/client/RestClientBuilder.java
index 3e38f9ae95dec..e5784296d7db6 100644
--- a/client/rest/src/main/java/org/opensearch/client/RestClientBuilder.java
+++ b/client/rest/src/main/java/org/opensearch/client/RestClientBuilder.java
@@ -63,7 +63,11 @@
  * Helps creating a new {@link RestClient}. Allows to set the most common http client configuration options when internally
  * creating the underlying {@link HttpAsyncClient}. Also allows to provide an externally created
  * {@link HttpAsyncClient} in case additional customization is needed.
+ *
+ * @deprecated the {@code RestClient} is deprecated is going to be removed in future releases, please consider using official
+ * OpenSearch Java Client or {@code RestHighLevelClient}
  */
+@Deprecated
 public final class RestClientBuilder {
     /**
      * The default connection timeout in milliseconds.