Dear all, I am starting a new thread because the old one started to be overloaded. I have started to write some media types that could be used as the representations returned by our RESTful API. It's a first attempt but they already contain some ideas and the guiding design principle I would like to follow. You can find them on http://dev.xwiki.org/xwiki/bin/view/Design/RestfulAPI Comments are welcome. -Fabio