updated a few fields in the API spec