http://www.kennethlange.com/posts/7_tips_for_designing_a_better_rest_api.html It violates the notion of outside-in design. Section 5 in above link