add RAML API spec
Add response example to raml docs