Fix REST API documentation

Since the API documentation is maintained by hand, there are crept in some inconsistencies between the documentation and the real API.

Some of this inconsistencies are listed in the attached document and should be:

• verfiefied agains the latest version if translate5,
  if the docu is wrong then
• fix the documentation

Attention: the different guid version in the attached document is no error, since the client created the document is using a different guid format, in the documentation we use just the default one.