Update notes for submitted changes

* Corrects some inconsistencies in REST API spec