Updated the Comments in the API

The comments in the api section now more accurately reflect the
functionality of the API