update api.py with notes