add in notes about API