Update README.md

This updates the API Teams read me with the information from backend. In other words description of the API calls, that are now possible through .Yaml, have been carried over from Backend to the API module ReadMe file. The Contents was also changed to match any changes made by the API team to the original API calls