added "add to favorites" api method
updated "add to favorites" api method to return the object just added
updated api.md with Add to Favorites