Fleshed out the API specification