Clear Cache API rest spec not up to date

[Mpdreamz]

POST http://127.0.0.1:9200/_cache/clear?pretty=true&recycler=true HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: 127.0.0.1:9200
Content-Length: 0

HTTP/1.1 400 Bad Request
content-type: application/json; charset=UTF-8
content-length: 348

{
  "error" : {
    "root_cause" : [
      {
        "type" : "illegal_argument_exception",
        "reason" : "request [/_cache/clear] contains unrecognized parameter: [recycler]"
      }
    ],
    "type" : "illegal_argument_exception",
    "reason" : "request [/_cache/clear] contains unrecognized parameter: [recycler]"
  },
  "status" : 400
}

https://github.com/elastic/elasticsearch/blob/6.0/rest-api-spec/src/main/resources/rest-api-spec/api/indices.clear_cache.json#L49

recycler is no longer allowed but still documented.

[jasontedor]

Can you submit a PR @Mpdreamz?

[Mpdreamz]

@jasontedor thank you forgot to assign myself.

[nik9000]

@Mpdreamz are you still interested in fixing this one?

[javanna]

just realized that I found this and I am addressing it as part of #28866 .