completed the api descriptions