Specific API reference documentation including the entity and supported HTTP methods in a swagger yaml format. These are to be specified using the http://swagger.io formatting which provides a handy editor at http://editor.swagger.io/#/ to create, validate and visualize the API. It is suggested that one start with one of the existing specifications already here and just edit the values.