There are several things in the wrangler rest APIs that should be cleaned up. Some examples include:
boolean fields that are currently strings
incorrect method (ex: PUT instead of POST)
strange response hierarchies (specification responses)
redundant and possibly unused information (connection type and id in response of a connection call)
This doesn't include the connection APIs, which should be re-designed.