This API page should follow the format specified in https://github.com/elastic/docs/blob/master/shared/api-ref-ex.asciidoc (similar to the other cluster APIs).  This cleanup can occur in a subsequent PR, however.