Here's some more thoughts on API standards. Some overlapping but still worth reading and apply where needed to our standards https://github.com/interagent/http-api-design