Bring over some of the api comment from the rest api here since that would be converted into javadoc in some generated code (or whatever the language might be).