first commit of api spec

I'd like to mention that there should be no markup. What about adding this somewhere:
> Text fields must be plaintext and must not contain any Markdown or HTML, including escape sequences such as `&amp;`).