add examples of REST responses