iterated on the API spec