document RESTful API for users/groups/devices/data
collapse deeply nested definitions for easier reading, a few language updates, group functionality in the list of endpoints