update API documentation as of ad64e7ade416d9e240931a88bdcac362d24f8179