rest interface is not self documenting

Mildly annoying - the rest is not self documenting - i typed the url it provides and then it complains that I am missing information. It would be nice if it told you what info it needed in the earlier screen or at least give an indication of how to fix it in the error messages