diff --git a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.clear_cache.json b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.clear_cache.json
index 1f24199fad4..1523c722da3 100644
--- a/rest-api-spec/src/main/resources/rest-api-spec/api/indices.clear_cache.json
+++ b/rest-api-spec/src/main/resources/rest-api-spec/api/indices.clear_cache.json
@@ -14,7 +14,7 @@
       "params": {
         "field_data": {
           "type" : "boolean",
-          "description" : "Clear field data"
+          "description" : "Clear field data. This is deprecated. Prefer `fielddata`."
         },
         "fielddata": {
           "type" : "boolean",
@@ -22,7 +22,7 @@
         },
         "fields": {
           "type" : "list",
-          "description" : "A comma-separated list of fields to clear when using the `field_data` parameter (default: all)"
+          "description" : "A comma-separated list of fields to clear when using the `fielddata` parameter (default: all)"
         },
         "query": {
           "type" : "boolean",