completing RAML doc for API interface