Updated API spec for markdown

The API spec rendered fine on github flavored markdown renderers, but
plain markdown renderers didn't like the code formatting for the example
responses.

They've been fixed.