added examples of success and failure responses