Additional improvements to the API spec