# Rest client library documentation doesn't warn about removal of DeleteIndexResponse class, as well as change of method signature of delete()

**URL:** https://discuss.elastic.co/t/rest-client-library-documentation-doesnt-warn-about-removal-of-deleteindexresponse-class-as-well-as-change-of-method-signature-of-delete/267091
**Category:** Meta Elastic
**Created:** [March 12, 2021, 1:21pm UTC](https://discuss.elastic.co/t/rest-client-library-documentation-doesnt-warn-about-removal-of-deleteindexresponse-class-as-well-as-change-of-method-signature-of-delete/267091 "2021-03-12T13:21:38Z")
**Posts on this page:** 2
**Page:** 1

<div class="post-metadata">

### Author: ![Hrafnahnef](https://avatars.discourse-cdn.com/v4/letter/h/c67d28/32.png) [@Hrafnahnef](https://discuss.elastic.co/u/Hrafnahnef)
#### Post date: [March 12, 2021, 1:21pm UTC](https://discuss.elastic.co/t/rest-client-library-documentation-doesnt-warn-about-removal-of-deleteindexresponse-class-as-well-as-change-of-method-signature-of-delete/267091/1 "2021-03-12T13:21:38Z")

</div>

Hi!

Forgive me, if I'm posting this to the wrong place.

I'd like to report a bug in the documentation for the [6.4](https://www.elastic.co/guide/en/elasticsearch/client/java-rest/6.4/java-rest-high-delete-index.html), [6.5](https://www.elastic.co/guide/en/elasticsearch/client/java-rest/6.5/java-rest-high-delete-index.html) and [all subsequent versions of the documentation](https://www.elastic.co/guide/en/elasticsearch/client/java-rest/current/java-rest-high-delete-index.html) for the elasticsearch rest clients.

The documentation for 6.4 gives the following API usage:

> **DeleteIndexResponse** deleteIndexResponse = client.indices().delete(request, RequestOptions.DEFAULT);

But the documentation for 6.5 gives to following API usage:

> **AcknowledgedResponse** deleteIndexResponse = client.indices().delete(request, RequestOptions.DEFAULT);

However, the `DeleteIndexResponse` class was never deprecated in 6.4, prior to its removal in 6.5, as is customary (and widely practised by your project normally). Neither in the source code, nor in the Javadocs for 6.4 ([class](https://artifacts.elastic.co/javadoc/org/elasticsearch/elasticsearch/6.4.3/org/elasticsearch/action/admin/indices/delete/DeleteIndexResponse.html?is-external=true), [IndicesClient usage](https://artifacts.elastic.co/javadoc/org/elasticsearch/client/elasticsearch-rest-high-level-client/6.4.3/org/elasticsearch/client/IndicesClient.html)).

Nor was I able to find any deprecation/removal notice in any changelog between 6.4 and 6.5 (but that could be my omission).

Unfortunately, this class **was** indeed removed (and the `delete` method signature was changed) in 6.5 without a previous deprecation.

Now, I'm not here to complain or blame. Code that is long since removed is already removed. 🙂 "_No reason to cry over spilled milk_", as the saying goes.

But I would kindly ask you to consider updating the aforementioned API documentation for all versions after 6.5 with a note for the section ["Synchronous Execution"](https://www.elastic.co/guide/en/elasticsearch/client/java-rest/current/java-rest-high-delete-index.html#java-rest-high-delete-index-sync) that the API changed between versions 6.4 and 6.5, and that you can safely change instances of `DeleteIndexResponse` to `AcknowledgedResponse` as `DeleteIndexResponse` was an empty subclass of `AcknowledgedResponse`, functionally identical to its superclass.

Thanks for your understanding!

---

<div class="post-metadata">

### Author: ![system](https://us1.discourse-cdn.com/elastic/original/3X/1/a/1ac57faf039f6b580b3f104ef42a2a89e41014de.png) [@system](https://discuss.elastic.co/u/system)
#### Post date: [April 9, 2021, 1:22pm UTC](https://discuss.elastic.co/t/rest-client-library-documentation-doesnt-warn-about-removal-of-deleteindexresponse-class-as-well-as-change-of-method-signature-of-delete/267091/2 "2021-04-09T13:22:02Z")

</div>

This topic was automatically closed 28 days after the last reply. New replies are no longer allowed.
