Make the API fully RESTful with

[ccherot]

Although this is not a public API, as a matter of practice the REST API should have hypermedia returned to make it truly RESTful

[ccherot]

Here some interesting info on hypermedia in RESTful APIs with some interesting links concerning the debate about its usefulness