Added details on how we want the API to behave